@pirireis/webglobeplugins 0.6.18 → 0.6.20

package/circle-line-chain/chain-api.md

@@ -1,336 +0,0 @@
-
-## insertBulk
-```json
-[
-    {
-    "chainID": "Mağrib",
-        "points": [
-            {
-                "id": "Fas",
-                "long": 0,
-                "lat": 0,
-            },
-            {
-                "id":"Cezayir",
-                "long": 10,
-                "lat": 20,
-            },
-            {
-                "id":"Tunus",
-                "long": 10,
-                "lat": 15
-            }
-        ],
-        "rgba": [1,0,0,1],
-        "dashRatio": 0.1,
-        "dashOpacity": 0.5,
-        "circleDashAngle": 15,
-    },
-]
-```
-
-```js
-                                        // ["distance"]
-updateCoordinatesBulk( items, contextTextWriterIDs=[]) {
-    for ( const item of items){
-        this._updateCoordsChain(item.chainID, item.points);
-    }
-}
-
-_updateCoordsChain(chainID, nodes){
-    const chain = this._chainMap(chainID); // chain is a `list`
-    const updateIDs = [];
-    for ( let i = 0; i< chain.length; i++){
-        if ( )
-    }
-}
-```
-
-
-```js
-// text
-const textContextMap = new Map(
-[
-    [
-            "distance",
-            {
-                writer: new ContextTextWriter(globe,),
-                coordsAdaptor: (item, index, array) => { // 
-                    const { long, lat } = globe.Math.GetMidPoint(item.long, item.lat, item.endLong, item.endLat);
-                    return {
-                        long,
-                        lat,
-                    }
-                },
-                textAdaptor: (item) => {
-                    const distance = globe.Math.GetDist2D(item.long, item.lat, item.endLong, item.endLat);
-                    return distance.toFixed(2) + "m";
-                },
-
-            }
-        ]
-    ]
-)
-
-                                                        // ["distance"]
-updateCoordinatesBulk(items, textWriterInjectionSubSetIDs = []) { 
-    
-}
-
-_updateChainCoords(chainID, points){
-    this._updateCoordsBuffer();
-}
-
-```
-
-
----
-
-```js
-const connectNaive = (p1, p2) => {p1.set("to",p2);p2.set("from":p1)};
-const Tanca = new Map([["long", 0],[ "lat",0], ["from", null], ["to":null]]);
-const Cebelitarik = new Map([["long", 0],[ "lat",0], ["from", null], ["to":null]]);
-const Cezayir = new Map([["long", 0],[ "lat",0], ["from", null], ["to":null]]);
-const Tunus = new Map([["long", 0],[ "lat",0], ["from", null], ["to":null]]);
-const Tanca = {id, long,lat, toID}
-
-plugin.insertBulk([
-    {
-        chainID: "Mağrib",
-        points: [
-            {Tanca, to: Cebelitarik}
-            {Cebelitarik, to:"Cezayir"},
-            {Cezayir, to: "Tunus"}, // implicitly connects to Tunus
-            {Tunus, to:null}
-        ]),
-        rgba: [1.0, 0.0, 0.0, 1.0],
-        dashRatio: 0.1,
-        dashOpacity: 0.5,
-        circleDashAngle: 15,
-    }
-]);
-```
-Advantage: User knows patterns of position data.
-Disadventage: Not json. 
-Bug: How to insert into middle?
-
-
-coordinateAdaptor => (v, i, array) => {
-    return {
-        (v.long + array[i+1].long) / 2.0,
-    }
-}
-
-```js
-const connect = (chainMap, chainID, node) => {
-    const chain = chainMap.get(chainID);
-
-}
-
-```
----
-
-## updateCoordinatesBulk
-
-updates pointMap;
-then updates buffers from updated version of pointMap; 
-
-imparatively open next or prev 
-
-```json
-[
-    {
-        "chainID": "Mağrib",
-        "points": [
-            {
-                ""Fas"": {
-               "     "l"ong": 100,
-                    "lat": 30
-                }
-            }
-        ]
-     }
-]
-```
-
-
-## deleteBulk 
-
-```json
-[
-    {
-        "chainID": "Mağrib",
-        "all": false,
-        "points": [
-            "Fas"
-        ]
-    }
-]
-```
-
-
-## ContextTextWriter
-
-```js
-{
-
-    writer: new ContextTextWriter(globe),
-    coordsAdaptor: (item) => 
-        if (item.get("next") === null) return false;
-        const goe = {
-        long: point.get("long"),
-        lat: point.get("lat"),
-        endLong: point.get("next")?.get("long"),
-        endLat: point.get("next")?.get("lat")
-        }
-        return globe.getMidPoint(geo.long,geo.lat, geo.endLong, geo.endLat)
-        }
-    },
-    textAdaptor: (item) => {
-        const angle = item.long, item.lat, item.endLong, item.endLat
-        );
-        if (angle < 0) {
-            return (angle + 360).toFixed(2) + "°";
-        }
-        return angle.toFixed(2) + "°";
-    },
-}
-```
-
----
-
-```js
-class Chain{
-    constractor(id, {rgba = [1,0,0,1], dashOpacity = 1, dashRatio = 0.1, circleDashAngle = 30  } = []){
-        this.id = 0;
-        this.idMap = new Map();
-        this.list = [];
-        this._rgba = rgba;
-        this._dashOpacity = dashOpacity;
-        this._dashRatio = dashRatio;
-        this._circleDashAngle = this.circleDashAngle;
-    }
-
-    add(item, fromID = null){
-        this.idMap.set(item.id, item);
-        let drawIndex;
-        if (from === null) {
-            this.list.push(item);
-            drawIndex = this.list.length - 1;
-        }
-
-        for ( let i = 0 ; i < this.list.length ; i++){
-            if ( fromID === this.list[i].id) {
-                drawIndex = i;
-                this.list.splice(i, 0, item);
-            }
-        }
-
-        this._update( [i, i-1]);
-    }
-
-    nextID(id){
-        // for loop if data source is a list. not performand.
-        // pointer if data rouce is a node. Clunky
-        // reconstract the map on (!append) operation.  
-    }
-}
-
-```
-
----
-## Design Priorities
-
-user interaction. insert, update, get data
-some processies are callback. callbacks uses the pattern user insert the data
-
-ContextTextWriter Plugin interaction I provided was imparative. I fit to that context because item had required data.
-Current context has uses next objects data in the chain. 
-
-What is the imparative way to get next data?
-A `function` - A `pointer` 
-If I go with a `pointer` I need to get the data with a `pointer`
-How to I provide a `function` to get the next data?
-```js
-getNodeData(chainID, id){
-    return this.chainMap.get(chainID).get(id)
-}
-// Problem to use this function the object of getNodeData must be created before creating contextTextWriterMap.
-```
-
-how minimally hold the data
-
-how to render
-
-
-
-Edit mod. user asks chain data and bind placeholders. 
-
-
-
-## API
-
-
-
-getChain(chainID) =>  {pointID, long, lat}
-
-
-
-## explore pattern
-
-(x, index, array ) doesnt fit. 
-
-
-
-
-## insertBulk
-```json
-[
-    {
-    "chainID": "Mağrib",
-        "points": [
-            {
-                "id": "Fas",
-                "long": 0,
-                "lat": 0,
-                "to": "Cezayir"
-            },
-            {
-                "id":"Cezayir",
-                "long": 10,
-                "lat": 20,
-                "to": "Tunus"
-            },
-            {
-                "id":"Tunus",
-                "long": 10,
-                "lat": 15
-            }
-        ],
-        "rgba": [1,0,0,1],
-        "dashRatio": 0.1,
-        "dashOpacity": 0.5,
-        "circleDashAngle": 15,
-    },
-]
-```
-
-```js
-                                        // ["distance"]
-updateCoordinatesBulk( items, contextTextWriterIDs=[]) {
-    for ( const item of items){
-        this._updateCoordsChain(item.chainID, item.points);
-    }
-}
-
-_updateCoordsChain(chainID, nodes){
-    const chain = this._chainMap(chainID); // chain is a `list`
-  
-
-}
-```
-
-
-## 
-Get data from user with `to` keyword. implicitly add from keyword
-