Project

Loading a Project

To instruct netDecor to open a project sent from a webpage, call the window.NetDecor.Project.Open method:

window.NetDecor.Project.Open(buffer: Uint8Array, params: string);

buffer : Uint8Array – Typed array containing project data
params : String – JSON string with additional project metadata, including:
  id : string – Project ID. If provided, netDecor will include this ID when saving the project.
  name : string – Project name. If provided, netDecor will include this name when saving the project and display it in the top-level application bar, where it can be modified by the user.
  readOnly : boolean – Flag that designates the project as read-only. When enabled, the application will only allow access to the 'File', 'Help', and 'Basket' tabs. Additionally, making changes to the scene is prohibited. Note that the Save action remains available.

Example

  function whenReady(){
    var req = new XMLHttpRequest();

    req.open("GET","http://localhost:8001/project2.npf", true);
    req.responseType = "arraybuffer";

    req.onload = function (oEvent) {
      var blob = new Uint8Array(req.response);
      NetDecor.Project.Open(blob,
      JSON.stringify({id: "546536"}));
    };

    req.send();
  }

  RunNetPlusApp("appcontainer", "Build/", "{\"dbaddr\":\"http://dev.netdecor.cadprojekt.com.pl/Example-Database/\"}", whenReady);

Projects are loaded after the application is fully initialized and the basic database data has been downloaded. Projects are not queued; only the most recently sent project will be loaded. This means that after application startup, the last sent project will be displayed.

If both the buffer and params arguments are null, a new project window will be displayed instead. Example:

  RunNetPlusApp("appcontainer", "Build/", runParams, function(){
    NetDecor.Project.Open(null, null)
  });

This method will throw exceptions if an invalid project buffer is provided or if the params argument contains invalid data.

Saving a Project

To register an event handler for the save action, use the following method:

window.NetDecor.Events.RegisterEventHandler("SaveProject", function(buffer: Uint8Array, pngBuffer: Uint8Array, params: string));

buffer : Uint8Array – Byte array containing project data
pngBuffer : Uint8Array – Byte array containing the project preview (PNG format)
params : string – JSON string with project parameters, such as:
  id : string – Project ID. This will only be included if it was previously assigned.
  name : string – Project name.

Example

  function onReady(){
    NetDecor.Events.RegisterEventHandler("SaveProject",function(buffer, png, jsondata, items) {
      console.log("project size: "+ buffer.length);
      console.log("png size: " + png.length);
      console.log("json params: " + jsondata);
      console.log("items: " + items);
    });
  }
  RunNetPlusApp("appcontainer", "Build/", runParams, onReady);