Difference between revisions of "LFS Editor/Modeller"

From LFS Manual
Jump to navigationJump to search
m (→‎View modes: use definition lists)
(10 intermediate revisions by 2 users not shown)
Line 1: Line 1:
This page is intended as a reference manual for the LFS Modeller. For user guides and walkthroughs for various modeller features, see [[Modeller Guides]].
+
{{Under construction}}
 +
 
 +
This page is intended as a reference manual for the LFS Modeller - a feature of the [[LFS Editor]]. For user guides and walkthroughs for various modeller features, see [[Modeller Guides]].
  
 
[[image:LFS Editor welcome screen.jpg|thumb|Entry screen]]
 
[[image:LFS Editor welcome screen.jpg|thumb|Entry screen]]
Line 8: Line 10:
 
To be able to use the modeller, you must have an S3 license. To get the S3 license, you can visit the [https://www.lfs.net/shop/licenseselect LFS shop page].
 
To be able to use the modeller, you must have an S3 license. To get the S3 license, you can visit the [https://www.lfs.net/shop/licenseselect LFS shop page].
  
Once you have the editor installed and run the application, you will be presented with an entry screen. Click the "Modeller" button to enter the editor.
+
Once you have the editor installed and run the application, you will be presented with an entry screen. Click the {{button|Modeller}} button to enter the editor.
  
The modeller can also be entered from the [[Vehicle Editor]] by pressing the E key or clicking the "E - Edit Model" button on the right hand side of the vehicle editor.
+
The modeller can also be entered from the [[Vehicle Editor]] by pressing {{key press|E}} or clicking the {{old button|E - Edit Model|#a1a1ff}} button on the right hand side of the vehicle editor.
  
 
== General modeller tips ==
 
== General modeller tips ==
  
 
* The list of colours at the bottom left in 'tri' mode is a different view of the list of mappings in 'map' mode.
 
* The list of colours at the bottom left in 'tri' mode is a different view of the list of mappings in 'map' mode.
* When you select a triangle, its colour is selected in the bottom left list. If the list is long, click "cols : X" to bring the selected colour onto screen.
+
* When you select a triangle, its colour is selected in the bottom left list. If the list is long, click {{old button|cols : X|#ffffa1}} to bring the selected colour onto screen.
* In 'subob' mode you can select a subobject with CTRL + click while pointing at one of its surfaces.
+
* In 'subob' mode you can select a subobject with {{key press|Ctrl|click}} while pointing at one of its surfaces.
* In 'tri' mode, CTRL + click adds or removes triangles from the selection. ALT + click starts a new selection (one triangle).
+
* In 'tri' mode, {{key press|Ctrl|click}} adds or removes triangles from the selection. {{key press|Alt|click}} starts a new selection (one triangle).
* In the special view modes (like groups or mappings) the group select feature (CTRL + SHIFT + click) does a flood select within the group.
+
* In the special view modes (like groups or mappings) the group select feature ({{key press|Ctrl|Shift|click}}) does a flood select within the group.
* Press SHIFT+F to temporarily hide the editor buttons.
+
* Press {{key press|Shift|F}} to temporarily hide the editor buttons.
* To reduce clutter, use 'hide selected' to temporarily hide points and triangles, then 'unhide all' to show the again.
+
* To reduce clutter, use {{old button|hide selected|#ffffa1}} to temporarily hide points and triangles, then {{old button|unhide all|#a1ffa1}} to show the again.
  
 
== View modes ==
 
== View modes ==
Line 27: Line 29:
  
 
[[image:LFS_Editor_Modeller_view_modes.jpg|Modeller view modes]]
 
[[image:LFS_Editor_Modeller_view_modes.jpg|Modeller view modes]]
 +
<br>
 +
<br>
 +
 +
; {{old button|layers|#a1a1ff}}
 +
: Each colour represents triangles assigned to a particular layer. You can toggle layers on/off by clicking the layer buttons in the top left part of the screen.
 +
 +
; {{old button|wire|#a1a1ff}}
 +
: Shows the edges as a wireframe. The edges can have different colours:
 +
:* grey - two triangles share the edge. This is the normal condition for most edges in an object.
 +
:* red - an unshared edge - only one triangle uses this edge.
 +
:* cyan - three triangles share the edge.
 +
:* orange - four triangles share the edge.
  
'''layers''': Each colour represents triangles assigned to a particular layer. You can toggle layers on/off by clicking the layer buttons in the top left part of the screen.
+
: When you see an edge that is not grey, it may be intentional or it may draw your attention to a bug in the model. There are reasons to have unshared edges or multiple shared edges in some : : cases. But if it is not intentional, it may indicate a modelling error such as:
  
'''wire''': Shows the edges as a wireframe. The edges can have different colours:<br>
+
:* A double built triangle - this would appear as a cyan triangle where you expect grey triangles.
* grey - two triangles share the edge. This is the normal condition for most edges in an object.
+
:* A triangle connected to the wrong vertex - could cause unshared edges.
* red - an unshared edge - only one triangle uses this edge.
 
* cyan - three triangles share the edge.
 
* orange - four triangles share the edge.
 
  
When you see an edge that is not grey, it may be intentional or it may draw your attention to a bug in the model. There are reasons to have unshared edges or multiple shared edges in some cases. But if it is not intentional, it may indicate a modelling error such as:
+
: It's good to click wire mode occasionally and if you see edges that are not grey, make sure that you know the reason for them and that they are as intended.
  
* A double built triangle - this would appear as a cyan triangle where you expect grey triangles.
+
; {{old button|mappings|#a1a1ff}}
* A triangle connected to the wrong vertex - could cause unshared edges.
+
: Each colour represents a different mapping.
  
It's good to click wire mode occasionally and if you see edges that are not grey, make sure that you know the reason for them and that they are as intended.
+
; {{old button|flat|#a1a1ff}}
 +
: Flat shading of the triangles without being smoothed.
  
'''mappings''': Each colour represents a different mapping.
+
; {{old button|groups|#a1a1ff}}
 +
: Smoothing groups. The boundaries between different smoothing groups usually have a sharp edge. All triangles within one smoothing group have artificial smoothing applied. In this mode, you can assign different smoothing groups to triangles by going to the "tri" mode, selecing one or more triangles and clicking the group number at the top right corner.
  
'''flat''': Flat shading of the triangles without being smoothed.
+
; {{old button|gouraud|#a1a1ff}}
 +
: The default rendering of the model with [https://en.wikipedia.org/wiki/Gouraud_shading gouraud shading] applied. This is how the car should appear in game.
  
'''groups''': Smoothing groups. The boundaries between different smoothing groups usually have a sharp edge. All triangles within one smoothing group have artificial smoothing applied. In this mode, you can assign different smoothing groups to triangles by going to the "tri" mode, selecing one or more triangles and clicking the group number at the top right corner.
+
; {{old button|n.c.level|#a1a1ff}}
 +
: Normal contribution levels. Each triangle meeting at a vertex, within the same smoothing group, contributes to the [https://en.wikipedia.org/wiki/Normal_(geometry) normal] of that surface at that vertex. In fact, large triangles have a larger contribution. So for example you could make a simple "hardback book" shaped object and most of the apparent curvature would be on the spine of that book. But the spine would still be contributing to the normals, so the front and back faces of the "book" would still be a little curved. If, however, you set the normal contribution level" of the spine to zero, then the spine would not contribute to the normals at all. Then the front and back face of the book would look totally flat.
  
'''gouraud''': The default rendering of the model with [https://en.wikipedia.org/wiki/Gouraud_shading gouraud shading] applied.
+
; {{old button|l.r.swap|#a1a1ff}}
 +
: Driver swap modes. The triangles can have different colours:
 +
:* grey - applied to mirrored triangles, which do not have any swapping
 +
:* blue (static) - do not change sides when driver side is swapped
 +
:* red (swap) - change sides when driver side is swapped
  
'''n.c.level''': Normal contribution levels. TBD
+
<gallery widths="300px" heights="170px">
 +
LFS Editor Modeller layers mode.jpg|Layers
 +
LFS Editor Modeller wire mode.jpg|Wireframe
 +
LFS Editor Modeller mappings view.jpg|Mappings
 +
LFS Editor Modeller NC level mode.jpg|Normal contribution levels
 +
LFS Editor Modeller gouraud mode.jpg|Gouraud
 +
LFS Editor Modeller flat mode.jpg|Flat
 +
LFS Editor Modeller groups mode.jpg|Smoothing groups
 +
LFS Editor Modeller L.R. swap mode.jpg|Left/right swap
 +
</gallery>
  
'''l.r.swap''': Driver swap modes. The triangles can have different colours:<br>
+
{{Vehicle mods}}
* grey - applied to mirrored triangles, which do not have any swapping
 
* blue (static) - do not change sides when driver side is swapped
 
* red (swap) - change sides when driver side is swapped
 

Revision as of 09:30, 7 January 2022

TemplateIconUnderConstruction.png This page or section is being initially created, or is in the process of an expansion or major restructuring. You are welcome to assist in its construction by editing it.

This page is intended as a reference manual for the LFS Modeller - a feature of the LFS Editor. For user guides and walkthroughs for various modeller features, see Modeller Guides.

Entry screen
Modeller start screen

Starting the modeller

To be able to use the modeller, you must have an S3 license. To get the S3 license, you can visit the LFS shop page.

Once you have the editor installed and run the application, you will be presented with an entry screen. Click the Modeller button to enter the editor.

The modeller can also be entered from the Vehicle Editor by pressing E or clicking the E - Edit Model button on the right hand side of the vehicle editor.

General modeller tips

  • The list of colours at the bottom left in 'tri' mode is a different view of the list of mappings in 'map' mode.
  • When you select a triangle, its colour is selected in the bottom left list. If the list is long, click cols : X to bring the selected colour onto screen.
  • In 'subob' mode you can select a subobject with Ctrl + click while pointing at one of its surfaces.
  • In 'tri' mode, Ctrl + click adds or removes triangles from the selection. Alt + click starts a new selection (one triangle).
  • In the special view modes (like groups or mappings) the group select feature (Ctrl + ⇧ Shift + click) does a flood select within the group.
  • Press ⇧ Shift + F to temporarily hide the editor buttons.
  • To reduce clutter, use hide selected to temporarily hide points and triangles, then unhide all to show the again.

View modes

In the bottom right part of the screen, you can choose different view modes of the model:

Modeller view modes

layers
Each colour represents triangles assigned to a particular layer. You can toggle layers on/off by clicking the layer buttons in the top left part of the screen.
wire
Shows the edges as a wireframe. The edges can have different colours:
  • grey - two triangles share the edge. This is the normal condition for most edges in an object.
  • red - an unshared edge - only one triangle uses this edge.
  • cyan - three triangles share the edge.
  • orange - four triangles share the edge.
When you see an edge that is not grey, it may be intentional or it may draw your attention to a bug in the model. There are reasons to have unshared edges or multiple shared edges in some : : cases. But if it is not intentional, it may indicate a modelling error such as:
  • A double built triangle - this would appear as a cyan triangle where you expect grey triangles.
  • A triangle connected to the wrong vertex - could cause unshared edges.
It's good to click wire mode occasionally and if you see edges that are not grey, make sure that you know the reason for them and that they are as intended.
mappings
Each colour represents a different mapping.
flat
Flat shading of the triangles without being smoothed.
groups
Smoothing groups. The boundaries between different smoothing groups usually have a sharp edge. All triangles within one smoothing group have artificial smoothing applied. In this mode, you can assign different smoothing groups to triangles by going to the "tri" mode, selecing one or more triangles and clicking the group number at the top right corner.
gouraud
The default rendering of the model with gouraud shading applied. This is how the car should appear in game.
n.c.level
Normal contribution levels. Each triangle meeting at a vertex, within the same smoothing group, contributes to the normal of that surface at that vertex. In fact, large triangles have a larger contribution. So for example you could make a simple "hardback book" shaped object and most of the apparent curvature would be on the spine of that book. But the spine would still be contributing to the normals, so the front and back faces of the "book" would still be a little curved. If, however, you set the normal contribution level" of the spine to zero, then the spine would not contribute to the normals at all. Then the front and back face of the book would look totally flat.
l.r.swap
Driver swap modes. The triangles can have different colours:
  • grey - applied to mirrored triangles, which do not have any swapping
  • blue (static) - do not change sides when driver side is swapped
  • red (swap) - change sides when driver side is swapped


Caution.png It is proposed that this article be deleted.