Skip to content
This repository has been archived by the owner on Nov 8, 2024. It is now read-only.
/ DuGR Public archive

Commit

Permalink
update doc
Browse files Browse the repository at this point in the history
  • Loading branch information
Nico-Duduf committed Jun 18, 2024
1 parent efde190 commit eb61d91
Show file tree
Hide file tree
Showing 19 changed files with 27 additions and 16 deletions.
1 change: 1 addition & 0 deletions .gitignore
Original file line number Diff line number Diff line change
@@ -1,4 +1,5 @@
node_modules
__pycache__
build/

.foldex.*
Expand Down
5 changes: 5 additions & 0 deletions dist/libs/api.jsxinc
Original file line number Diff line number Diff line change
Expand Up @@ -172,6 +172,10 @@ DuGR.Group = {
* Camera layers
*/
CAMERA: 'DuGR.type.camera',
/**
* 3D Model layers
*/
THREED_MODEL: 'DuGR.type.threeDModel',
/**
* Visible layers
*/
Expand Down Expand Up @@ -455,6 +459,7 @@ DuGR.inGroups = function ( layer, groups, tag, and )
else if (group == DuGR.Group.ADJUSTMENT ) ok = DuAELayer.isAdjustment( layer );
else if (group == DuGR.Group.LIGHT ) ok = layer instanceof LightLayer;
else if (group == DuGR.Group.CAMERA ) ok = layer instanceof CameraLayer;
else if (group == DuGR.Group.THREED_MODEL ) ok = layer instanceof ThreeDModelLayer;
else if (group == DuGR.Group.VISIBLE ) ok = layer.enabled;
else if (group == DuGR.Group.SOUND ) ok = layer.hasAudio;
else if (group == DuGR.Group.SOLO ) ok = layer.solo;
Expand Down
21 changes: 11 additions & 10 deletions src-docs/docs/advanced/getting-started.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,15 +8,17 @@ The API and its documentation can be downloaded from **[RxLaboratory](https://rx

## Include it in your script

Just save the two files `DuGR_api.jsxinc` and `DuAEF_DuGR_api.jsxinc` in the folder where you're working and writing your own script.
The DuGR API comes in a few files:

- `DuAEF_DuGR_api.jsxinc` is the complete API, including all dependencies. This is the one you should use by default.
- `DuGR_API.jsxinc` is the complete API, including all dependencies. This is the only file you should include in your script by default.

- `DuGR_api.jsxinc` includes only the *DuGR API* without any dependencies. You'll have to include dependencies by yourself; The list of these dependencies can be found in the [API reference](http://dugr.rxlab.io/) (see *Requires* on the linked page). At the time we're writing this documentation, it's just *DuAEF*. You may use this file if you plan to combine several different API using *DuAEF*, to be sure to include it only once.
- A Subfolder called `libs` contains the actual API code, separated in a few different libraries. These may be useful if you need to handle specific versions of these libraries, if you know what you're doing... Have a look at the main `DuGR_API.jsxinc` file if you want to see in which order they should be included in your scripts.

All these files (both the `.jsxinc` file and the `libs` folder) need to be located next to your script in the following examples.

### Using only DuGR

If you're only needing the DuGR API, you just have to include `DuAEF_Duik_api.jsxinc` at the beginning of your own script.
If you're only needing the DuGR API, you just have to include `DuGR_API.jsxinc` at the beginning of your own script.

Here's an example.

Expand All @@ -26,13 +28,13 @@ Here's an example.
(function(thisObj)
{
// If you only need Duik, just include DuAEF_Duik_api at the beginning
#include "DuAEF_DuGR_api.jsxinc";
#include "DuGR_API.jsxinc";

```
### Combining the DuGR API with other APIs and DuAEF
If you're going to include APIs other than DuGR, you'll need to include everything separately to be sure that all frameworks are included only once. In this case, include `DuGR_api.jsxinc` and the other APIs at the beginning of your script.
If you're going to include APIs other than DuGR, you'll need to include everything separately to be sure that all frameworks are included only once. In this case, include the APIs at the beginning of your script.
Here's an example:
Expand All @@ -43,9 +45,8 @@ Here's an example:
{
// If you need to combine DuGR and other APIs like DuIO
// Include DuAEF first, and then stand-alone APIs
#include "DuAEF.jsxinc";
#include "DuGR_api.jsxinc";
#include "DuIO_api.jsxinc";
#include "libs/DuAEF.jsxinc";
#include "libs/api.jsxinc"; // DuGR API, you may rename it if needed.

// Now you can also include any other API which also depends on DuAEF or one of the above APIs
#include "another_API.jsxinc"
Expand Down Expand Up @@ -114,7 +115,7 @@ Don't forget to close the anonymous function we've created at the beginning to a
(function(thisObj)
{
// If you only need Duik, just include DuAEF_Duik_api at the beginning
#include "DuAEF_DuGR_api.jsxinc";
#include "DuGR_api.jsxinc";

// Running the init() method of DuAEF is required to setup everything properly.
DuAEF.init( "YourScriptName", "1.0.0", "YourCompanyName" );
Expand Down
4 changes: 2 additions & 2 deletions src-docs/docs/install.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,8 +21,8 @@ You'll find several folders and files.
- *README.txt* contains a lot of information to help you get started with DuGR.
- The *Help* folder contains these help pages. Double click on the file *index.html* to open it.
- The *Tools* folder may contain some useful tools.
- The *ScriptUI Panels* folder contains the actual *DuGR* script you need to install.
- The *Scriptlets* folder contains small scripts you can assign to [keyboard shortcuts](#keyboard-shortcuts) for example.
- The *Scripts* folder contains small scripts you can assign to [keyboard shortcuts](#keyboard-shortcuts) for example.
- The *Scripts/ScriptUI Panels* folder contains the actual *DuGR* script you need to install.

### **3 - Install**

Expand Down
2 changes: 1 addition & 1 deletion src-docs/mkdocs.yml
Original file line number Diff line number Diff line change
Expand Up @@ -31,7 +31,7 @@ extra_javascript:
site_dir: ../build/docs
dev_addr: '127.0.0.1:8002'
nav:
- v5.1.x: index.md
- v5.2.x: index.md
- Install: install.md
- Help: introduction.md
- Settings: settings.md
Expand Down
Binary file removed tools/assets/__pycache__/_setup_env.cpython-310.pyc
Binary file not shown.
6 changes: 3 additions & 3 deletions tools/assets/environment.json
Original file line number Diff line number Diff line change
Expand Up @@ -29,8 +29,8 @@
{ "src": "./tools/assets/LICENSE.txt", "dest": "DuGR/LICENSE.txt"},
{ "src": "./tools/assets/LICENSE.txt", "dest": "DuGR_API/LICENSE.txt"},
{ "src": "./tools/assets/README.txt", "dest": "DuGR/README.txt"},
{ "src": "./src/Scripts/DuGR_isolateGroup_comp viewer.jsx", "dest": "DuiGR_API/DuGR_isolateGroup_comp viewer.jsx"},
{ "src": "./src/Scripts/DuGR_isolateGroup_timeline.jsx", "dest": "DuiGR_API/DuGR_isolateGroup_timeline.jsx"},
{ "src": "./src/Scripts/DuGR_isolateGroup.jsx", "dest": "DuiGR_API/DuGR_isolateGroup.jsx"}
{ "src": "./src/Scripts/DuGR_isolateGroup_comp viewer.jsx", "dest": "DuGR_API/DuGR_isolateGroup_comp viewer.jsx"},
{ "src": "./src/Scripts/DuGR_isolateGroup_timeline.jsx", "dest": "DuGR_API/DuGR_isolateGroup_timeline.jsx"},
{ "src": "./src/Scripts/DuGR_isolateGroup.jsx", "dest": "DuGR_API/DuGR_isolateGroup.jsx"}
]
}
Binary file removed tools/rxbuilder/__pycache__/__init__.cpython-310.pyc
Binary file not shown.
Binary file not shown.
Binary file removed tools/rxbuilder/__pycache__/file_deploy.cpython-310.pyc
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file removed tools/rxbuilder/__pycache__/qt_build.cpython-310.pyc
Binary file not shown.
Binary file not shown.
Binary file removed tools/rxbuilder/__pycache__/utils.cpython-310.pyc
Binary file not shown.
4 changes: 4 additions & 0 deletions types/dugr/types.d.ts
Original file line number Diff line number Diff line change
Expand Up @@ -10114,6 +10114,10 @@ declare namespace DuGR {
* Camera layers
*/
CAMERA = "DuGR.type.camera",
/**
* 3D Model layers
*/
THREED_MODEL = "DuGR.type.threeDModel",
/**
* Visible layers
*/
Expand Down

0 comments on commit eb61d91

Please sign in to comment.