Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Added new screenshots and updated text for new edit handles #304

Open
wants to merge 2 commits into
base: master
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Binary file not shown.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
22 changes: 6 additions & 16 deletions 02.create-and-explore/04.entities/01.create-mode/docs.md
Original file line number Diff line number Diff line change
Expand Up @@ -45,15 +45,10 @@ You can exit the Create Mode by closing the window on the tablet.
- To pan around the object, click the right mouse button and drag left and right.
- To orbit over and under the object, click the right mouse button and drag up and down.


### Adding Entities Using the create Toolbar

When you click on the Create button, a window opens showing the different types of entities you can use. You can add an entity by clicking on the button for that entity. For instance, if you want to add a cube entity, click on cube.

![](create-add-cube.PNG)



Entities can be of the following types:

| Entity Type | Description |
Expand All @@ -75,11 +70,9 @@ You can edit an entity's position, rotation, and scale using your mouse or track

To edit an entity using the mouse or trackpad, you can select the entity or find it in the List tab in Create mode.

![](select-entity.PNG)
![](create-red-cube.PNG)

>>>>>By default, Light entities and Zone entities cannot be selected for editing. To be able to select Light entities, go to **Settings > Advanced Menus**, and then select **Edit Menu > Allow Selecting of Lights**. To select Zone entities, you must click on the Zone entity in the List tab.

You can tell an entity is selected when you see the bounding box and arrows around it. These arrows are the rotate and stretch widgets.
You can tell an entity is selected when you see the bounding box and handles around it. These handles are the rotate and stretch widgets.

With the entity selected, you can:

Expand Down Expand Up @@ -110,11 +103,11 @@ Grabbing the black squares at the edges of the entity bounding box enables you t

#### Rotating the Entity with the Mouse

Grabbing any of the three curved arrows enables rotation about one axis.
Grabbing any of the three multicolored circles enables rotation about one axis.

- Grab one of the curved arrows to rotate on that axis.
- Move the mouse closer to the object to snap to whole sizes.
- Move the mouse further away to rotate as free wheel (no snapping).
- Grab one of the circles to rotate on that axis.
- Move the mouse around the object to rotate it.
- The circle will display the rotation in degrees.
- You can undo this action by pressing the **CTRL/Z **keys together.

#### Duplicating the Entity with the Mouse
Expand Down Expand Up @@ -145,9 +138,6 @@ The *create* panel has three tabs: *Create*, *List*, and *Properties* and *Grid*

To list all of the entities on the domain, in the *create* panel, click the *List* tab and then click *Refresh* on the top-left corner of the panel. You can filter by entity type and by distance from the current location.

![](select-entity.PNG)


### Edit Entity Properties

Entity properties define an entity's appearance (color, size, position) and behavior (animation, collision, interaction) and much more. The entity type will define the specific set of properties the entity has.
Expand Down
Binary file not shown.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Original file line number Diff line number Diff line change
Expand Up @@ -33,19 +33,11 @@ You can view and edit these properties in [Create Mode](../create-mode) by selec
To change the color of a cube to yellow:

1. Add a Box entity by going to **Create** and clicking on the cube button.

2. When you add the cube, the Properties tab opens.

3. Select the cube.

4. Scroll down until you see the Entity color option.

![](cube-properties.PNG)

![](create-red-cube.PNG)
The current values are Red: 255, Green: 0, and Blue: 0.

5. To change the cube's color to yellow, change the Green value to 255.

![](cube-yellow.PNG)

![](create-yellow-cube.PNG)
If you use the carats to change the value, as you increase the value you should see the cube change from red, to orange, to yellow. If you enter in 255, you will see the cube change to yellow as soon as you press enter.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
46 changes: 12 additions & 34 deletions 02.create-and-explore/04.entities/03.light-entities/docs.md
Original file line number Diff line number Diff line change
Expand Up @@ -26,26 +26,6 @@ You won't see any light unless there is an entity to reflect the light. In the i

By default, Light entities cannot be selected for editing nor will they be visible to select.

### Make Light Entities Visible in Edit Mode

Other than their reflected light, Light entities are not visible. To make it easier to find exactly where a light is to select it, you can make lights visible in edit mode. To make lights visible in edit mode:

1. Select **Settings > Advanced Menus**.
2. Select **Edit Menu > Show Lights in Edit Mode**.
![](edit-show-light.PNG)

When **Show Lights in Edit Mode** is enabled, lights appear as a gray rectangle.

### Enable Selecting of Lights for Editing

To select a Light entity for editing, you must first enable selecting of lights. To enable the selecting of Light entities for editing:

1. Select **Settings > Advanced Menus**.
2. Select **Edit Menu > Allow Selecting of Lights**.
![](edit-light-select.PNG)

Now, you should be able to click on a light entity to select it. You will see the entity's bounding box appear and the create mode arrows for changing the entity's position, size, and rotation will also appear. When a light entity is selected, you can edit its properties in the **Properties** tab in the *Create* panel.

## Example: Shine a Pink Spotlight on a Wall

To demonstrate how Light entities work this example creates a pink spotlight shining down a wall. For this example, you will need to:
Expand All @@ -61,13 +41,8 @@ The next sections cover these steps in detail followed by a section covering som
To create a wall to shine the light on, in [Create Mode](../create-mode), complete these steps:

1. Click the **Cube** icon to [create a Box entity](../box-and-sphere-entities).
2. Select the **Properties** tab in the *Create* panel and make the following changes to the box properties:
![](light-fall-off.PNG)

Assuming you are in third person view, if you use the scroll wheel to zoom back, you should now have a "wall" that looks something like this:

![](wall.PNG)

2. Use the multicolored balls to shape the **Cube** into a large flat wall.
![](create-grey-wall.PNG)

### Create a Light Entity

Expand All @@ -76,12 +51,12 @@ To create a Light entity, complete these steps:
1. Ensure that selecting of Light entities is enabled.
2. Click the **Light** icon to create a light.
3. Grab the Light entity and move it so that it is centered on the wall.
![](light-on-wall.PNG)
![](create-light.PNG)
You'll notice that you don't see any light. This is because the radius of the light is too small and the brightness is too low.
4. In the Properties tab, scroll down to the Light properties to change the Intensity to 100. The intensity is the brightness 100of the light - a higher intensity corresponds with a brighter light. You should see the spot brighten up.
![](light-int.PNG)
![](create-light-intensity.PNG)
5. Change the Fall-off radius to 0.5. The Fall-off radius defines the shape of the light curve of a light. A larger radius will simulate a larger light, which will "falloff", or dim, more gradually. Specifically, it is the distance from the light at which the intensity is reduced by 25%. You should see the light radius increase.
![](light-fall-off.PNG)
![](create-light-falloff.PNG)

This type of light is a point light and it emanates in all directions equally. It is meant for general area lighting as it has a bright point in the middle and fades as it radiates out.

Expand All @@ -91,13 +66,16 @@ To edit the Light to be a pink spotlight, complete these steps:

1. Scroll down to the *Light* properties, click the box for **Spotlight**.
2. Change the Spotlight cut-off to 30. This property determines the radius of the spotlight. A higher cut-off value corresponds with a larger spotlight radius. You should see the beam tighten up to a smaller beam.
![](spotlight-cut-off.PNG)
![](create-light-spotlight.PNG)
3. Rotate the Spotlight to better expose the next several changes.
![](create-light-spotlight-turned.PNG)
3. Change the Spotlight exponent to 20. This property affects the softness of the beam. You should see the edge of the beam soften.
![](spotlight-exp.PNG)
You can experiment with different exponent, cutoff, and intensity combinations for varied effects.
![](create-spotlight-exponent.PNG)
You can experiment with different exponent, cutoff, and intensity combinations for varied effects.
4. Change the Light color to pink by adjusting the color values to Red: 255, Green: 0 , Blue 255.
![](create-spotlight-pink.PNG)
5. Adjust the light's Rotation so that the spotlight is facing down the wall. A spotlight positioned like this can be used for a good effect over paintings or wall hangings in your world.
![](pink-light.PNG)
![](create-spotlight-down.PNG)

### Issues

Expand Down
Binary file not shown.
Binary file not shown.
Binary file not shown.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Binary file modified 02.create-and-explore/04.entities/04.web-entities/web-entity.PNG
14 changes: 3 additions & 11 deletions 02.create-and-explore/04.entities/05.particle-entities/docs.md
Original file line number Diff line number Diff line change
Expand Up @@ -24,20 +24,12 @@ A particle entity first appears as a fountain of small white particles.

Particle entities have the properties common to all entities as well as additional particle specific properties.

To edit the particle entity, select the **Particle Explorer** tab. This is indicated by a small particle icon on the top-right hand corner of your tablet.

![](particle-explorer.PNG)

Click on open controls to see the entity's properties.

![](particle-properties.PNG)

When you create or select a Particle entity you can edit these properties from the Particle menu.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can you add a comma after entity


![](particle-property.PNG)

>>>>> The **Color** property appears in both, the **Properties** tab and the **Particle Explorer** tab. This is the same property. But, when you change the value in one tab, the value isn’t updated in the other. it is reflected in both places only once you select another entity and then re-select the particle entity.



Below is an image of a particle entity with a different color.

![](purple-particle.PNG)
![](particle-pink.PNG)
Diff not rendered.
14 changes: 6 additions & 8 deletions 02.create-and-explore/04.entities/06.text-entities/docs.md
Original file line number Diff line number Diff line change
Expand Up @@ -30,9 +30,9 @@ Text entities have the properties common to all entities as well as one addition

You can view and edit these properties in [Create Mode](../create-mode) by selecting the entity and then selecting the **Properties** tab in the *Edit* panel.

## Example: Create a Green "Welcome" Sign
## Example: Create a Green Sign with Pink Text

For example, to create a text entity that displays the word "Welcome!" in big black letters on a green plane, complete the following steps:
For example, to create a text entity that displays sample text in pink text on a green plane, complete the following steps:

1. Create and position the text entity.
2. Change and resize the text displayed.
Expand All @@ -51,13 +51,11 @@ To change and resize the text displayed, you need to edit the entity properties.

1. With the text entity selected, click the **Properties** tab.
2. Scroll to the bottom of the panel where you will find the Text entity specific properties.
3. Change the text displayed to "Welcome!". For your own projects, if you plan to display a lot of text, you can first type the text into a plain text editor and then copy and paste the text into the **Text content** field. Press enter or click on another active field and the updated text should appear.
3. Change the text to whatever you please. For your own projects, if you plan to display a lot of text, you can first type the text into a plain text editor and then copy and paste the text into the **Text content** field. Press enter or click on another active field and the updated text should appear.
4. Change the size of the text. Below the **Text content** field is the **Line height** field. This value controls how big the font will be.

If you use the up and down carats to change the value, the value will change by 0.005 per click. If you enter a value, you will see the text change as soon as you press enter. The Line height default value is 0.06. For this example, the Line height was set to 0.1550.

![](welcome-text.PNG)

If the text is too big to fit, you can increase the size of the entity.

### Change Background and Text Colors
Expand All @@ -66,10 +64,10 @@ To change the background and text colors, in the **Properties** tab:

1. Scroll down to the **Text color** and **Background color** properties.
2. Change the RGB values to the following:
- Text color- Black (Red: 0, Green:0, Blue: 0)
- Background color - Green (Red: 0, Green:255, Blue: 0).
- Text color- Black (Red: 255, Green:0, Blue: 0)
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

In the picture, the pink text color has a Blue: 255 value as well. Can you confirm?

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

and it says text Color - Black

- Background color - Green (Red: 0, Green:64, Blue: 0).

![](welcome-green.PNG)
![](colored-text.PNG)

If you use the carats to change the value, as you click to increase or decrease the value you should see the text or background change with each click. If you enter in the values directly, you will see the text or background change as soon as you press enter or click on another active field.

Expand Down
Binary file modified 02.create-and-explore/04.entities/06.text-entities/some-text.PNG
Diff not rendered.
Diff not rendered.