Difference between revisions of "IC Python API:Saving JSON"
From Reallusion Wiki!
Chuck (RL) (Talk | contribs) m (→Reading Back the JSON File) |
Chuck (RL) (Talk | contribs) m |
||
| Line 14: | Line 14: | ||
import json | import json | ||
</syntaxhighlight> | </syntaxhighlight> | ||
| + | |||
| + | {{clear}} | ||
== Global Variables == | == Global Variables == | ||
| Line 30: | Line 32: | ||
== Recording Transform Data == | == Recording Transform Data == | ||
| + | |||
| + | [[File:Ic_python_api_saving_json_01.png|right]] | ||
Since we have a list of all the props in the scene from the previous step, we'll need to iterate over each and every one and make an entry into the JSON '''data''' global variable. | Since we have a list of all the props in the scene from the previous step, we'll need to iterate over each and every one and make an entry into the JSON '''data''' global variable. | ||
| Line 62: | Line 66: | ||
Keep in mind that scale data shown in iClone's '''Modify''' panel is percentage based but is read and written into the '''data block''' in floating point values. This is to say a scale of 100 in the '''Modify''' panel is 1.0 in the scale value of the '''data block'''. | Keep in mind that scale data shown in iClone's '''Modify''' panel is percentage based but is read and written into the '''data block''' in floating point values. This is to say a scale of 100 in the '''Modify''' panel is 1.0 in the scale value of the '''data block'''. | ||
| − | == Saving the JSON File == | + | == JSON Encoding and Decoding == |
| + | |||
| + | [[File:Ic_python_api_saving_json_02.png|right]] | ||
| + | |||
| + | The primary encoding interface for '''json''' is '''dump''' and '''dumps'''. The difference being that '''dump''' is suitable for writing data to file/socket, while '''dumps''' is for string operations such as printing and parsing. | ||
| + | |||
| + | === Saving the JSON File === | ||
| + | |||
| + | We'll need to write the transformation data to a file located in the same directory as the script itself, called '''all_prop_transforms.json'''. | ||
<syntaxhighlight lang="Python"> | <syntaxhighlight lang="Python"> | ||
| Line 75: | Line 87: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
| − | == Reading Back the JSON File == | + | === Reading Back the JSON File === |
| + | |||
| + | Finally, we will load the same data from file and use '''json.dumps''' to pretty print the content. | ||
<syntaxhighlight lang="Python"> | <syntaxhighlight lang="Python"> | ||
| Line 84: | Line 98: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
| + | '''Prettyprint''' (or '''pretty-print''') is the application of any of various stylistic formatting conventions to text files, such as source code, markup, and similar kinds of content. These formatting conventions can adjust positioning and spacing (indent style), add color and contrast (syntax highlighting), adjust size, and make similar modifications intended to make the content easier for people to view, read, and understand. | ||
== Everything Put Together == | == Everything Put Together == | ||
| + | |||
| + | [[File:Ic_python_api_saving_json_03.png|right|The contents within the '''all_prop_transforms.json''' file is not formatted easy viewing.]] | ||
You can copy and paste the following code into a PY file and load it into iClone via '''Script > Load Python'''. Make sure to have the scene prepared beforehand by populating it with props in various states of transformations. | You can copy and paste the following code into a PY file and load it into iClone via '''Script > Load Python'''. Make sure to have the scene prepared beforehand by populating it with props in various states of transformations. | ||
| Line 139: | Line 156: | ||
print(json.dumps(data_in, indent=4, sort_keys=True)) | print(json.dumps(data_in, indent=4, sort_keys=True)) | ||
</syntaxhighlight> | </syntaxhighlight> | ||
| − | |||
== APIs Used == | == APIs Used == | ||
Revision as of 22:03, 8 March 2020
- Main article: RL Python Samples.
Related article: Loading JSON.
This article will go over the handling of JSON formatted data for iClone. This is done by saving transformational data for all the props in the current iClone scene to an external .json file. For this lesson, you'll need to create an iClone scene containing at least one prop.
Necessary Modules
Besides the fundamental Reallusion Python module, we'll also need Pyside2 to build the user interface, os to read/write to file, and json to interpret/convert JSON data.
import RLPy
import os
import json
Global Variables
Now we'll need some global variables for inputting object transformation data, creating an "exclusion" list for objects we don't want, and listing all the props in the scene; among other things.
data = {"props": []} # Empty array to store object data
time = RLPy.RTime(0)
decimal_places = 3 # How accurately do we want to store the transform data?
exclusions = ["Shadow Catcher "] # Create a list objects to ignore when saving
all_props = RLPy.RScene.FindObjects(RLPy.EObjectType_Prop)
Notice that we have an optional decimal_places variable to control the accuracy of the stored data.
Recording Transform Data
Since we have a list of all the props in the scene from the previous step, we'll need to iterate over each and every one and make an entry into the JSON data global variable.
for prop in all_props:
if prop.GetName() in exclusions:
continue
control = prop.GetControl("Transform")
data_block = control.GetDataBlock()
data["props"].append(
{"Name": prop.GetName(),
"Position": {
"x": round(data_block.GetData("Position/PositionX", time).ToFloat(), decimal_places),
"y": round(data_block.GetData("Position/PositionY", time).ToFloat(), decimal_places),
"z": round(data_block.GetData("Position/PositionZ", time).ToFloat(), decimal_places)
},
"Rotation": {
"x": round(data_block.GetData("Rotation/RotationX", time).ToFloat(), decimal_places),
"y": round(data_block.GetData("Rotation/RotationY", time).ToFloat(), decimal_places),
"z": round(data_block.GetData("Rotation/RotationZ", time).ToFloat(), decimal_places)
},
"Scale": {
"x": round(data_block.GetData("Scale/ScaleX", time).ToFloat(), decimal_places),
"y": round(data_block.GetData("Scale/ScaleY", time).ToFloat(), decimal_places),
"z": round(data_block.GetData("Scale/ScaleZ", time).ToFloat(), decimal_places)
}
}
)
Keep in mind that scale data shown in iClone's Modify panel is percentage based but is read and written into the data block in floating point values. This is to say a scale of 100 in the Modify panel is 1.0 in the scale value of the data block.
JSON Encoding and Decoding
The primary encoding interface for json is dump and dumps. The difference being that dump is suitable for writing data to file/socket, while dumps is for string operations such as printing and parsing.
Saving the JSON File
We'll need to write the transformation data to a file located in the same directory as the script itself, called all_prop_transforms.json.
# Prepare the filepath and save the json file
file_name = "all_prop_transformations.json"
local_path = os.path.dirname(os.path.realpath(__file__))
json_file_path = os.path.join(local_path, file_name)
with open(json_file_path, "w") as json_file:
json.dump(data, json_file)
Reading Back the JSON File
Finally, we will load the same data from file and use json.dumps to pretty print the content.
# Read back the data and pretty print it in the console
with open(json_file_path, "r") as json_file:
data_in = json.load(json_file)
print(json.dumps(data_in, indent=4, sort_keys=True))
Prettyprint (or pretty-print) is the application of any of various stylistic formatting conventions to text files, such as source code, markup, and similar kinds of content. These formatting conventions can adjust positioning and spacing (indent style), add color and contrast (syntax highlighting), adjust size, and make similar modifications intended to make the content easier for people to view, read, and understand.
Everything Put Together
You can copy and paste the following code into a PY file and load it into iClone via Script > Load Python. Make sure to have the scene prepared beforehand by populating it with props in various states of transformations.
import RLPy
import os
import json
data = {"props": []} # Empty array to store object data
time = RLPy.RTime(0)
decimal_places = 3 # How accurately do we want to store the transform data?
exclusions = ["Shadow Catcher "] # Create a list objects to ignore when saving
all_props = RLPy.RScene.FindObjects(RLPy.EObjectType_Prop)
for prop in all_props:
if prop.GetName() in exclusions:
continue
control = prop.GetControl("Transform")
data_block = control.GetDataBlock()
data["props"].append(
{"Name": prop.GetName(),
"Position": {
"x": round(data_block.GetData("Position/PositionX", time).ToFloat(), decimal_places),
"y": round(data_block.GetData("Position/PositionY", time).ToFloat(), decimal_places),
"z": round(data_block.GetData("Position/PositionZ", time).ToFloat(), decimal_places)
},
"Rotation": {
"x": round(data_block.GetData("Rotation/RotationX", time).ToFloat(), decimal_places),
"y": round(data_block.GetData("Rotation/RotationY", time).ToFloat(), decimal_places),
"z": round(data_block.GetData("Rotation/RotationZ", time).ToFloat(), decimal_places)
},
"Scale": {
"x": round(data_block.GetData("Scale/ScaleX", time).ToFloat(), decimal_places),
"y": round(data_block.GetData("Scale/ScaleY", time).ToFloat(), decimal_places),
"z": round(data_block.GetData("Scale/ScaleZ", time).ToFloat(), decimal_places)
}
}
)
# Prepare the filepath and save the json file
file_name = "all_prop_transformations.json"
local_path = os.path.dirname(os.path.realpath(__file__))
json_file_path = os.path.join(local_path, file_name)
with open(json_file_path, "w") as json_file:
json.dump(data, json_file)
# Read back the data and pretty print it in the console
with open(json_file_path, "r") as json_file:
data_in = json.load(json_file)
print(json.dumps(data_in, indent=4, sort_keys=True))
APIs Used
You can research the following references for the APIs deployed in this code.
