diff options
Diffstat (limited to 'app/doc')
-rw-r--r-- | app/doc/CMakeLists.txt | 161 | ||||
-rw-r--r-- | app/doc/addm.but | 277 | ||||
-rw-r--r-- | app/doc/appendix.but | 29 | ||||
-rw-r--r-- | app/doc/changem.but | 583 | ||||
-rw-r--r-- | app/doc/clean-html.cmake | 6 | ||||
-rw-r--r-- | app/doc/clean-html.cmake.in | 6 | ||||
-rw-r--r-- | app/doc/drawm.but | 241 | ||||
-rw-r--r-- | app/doc/editm.but | 122 | ||||
-rw-r--r-- | app/doc/filem.but | 171 | ||||
-rw-r--r-- | app/doc/helpm.but | 11 | ||||
-rw-r--r-- | app/doc/hhc.cmake.in | 12 | ||||
-rw-r--r-- | app/doc/hotbar.but | 32 | ||||
-rw-r--r-- | app/doc/intro.but.in | 161 | ||||
-rw-r--r-- | app/doc/managem.but | 149 | ||||
-rwxr-xr-x | app/doc/mk-xtrkcad-manual-html | 93 | ||||
-rw-r--r-- | app/doc/navigation.but | 27 | ||||
-rw-r--r-- | app/doc/optionm.but | 50 | ||||
-rw-r--r-- | app/doc/png.d/bangle.png | bin | 0 -> 761 bytes | |||
-rw-r--r-- | app/doc/png.d/bblock.png | bin | 713 -> 1093 bytes | |||
-rw-r--r-- | app/doc/png.d/bbridge.png | bin | 0 -> 1043 bytes | |||
-rw-r--r-- | app/doc/png.d/bcircl1.png | bin | 324 -> 1729 bytes | |||
-rw-r--r-- | app/doc/png.d/bcircl2.png | bin | 340 -> 1628 bytes | |||
-rw-r--r-- | app/doc/png.d/bcircl3.png | bin | 328 -> 1584 bytes | |||
-rw-r--r-- | app/doc/png.d/bcircle.png | bin | 370 -> 1718 bytes | |||
-rw-r--r-- | app/doc/png.d/bconnect.png | bin | 307 -> 746 bytes | |||
-rw-r--r-- | app/doc/png.d/bcontrol.png | bin | 619 -> 945 bytes | |||
-rw-r--r-- | app/doc/png.d/bcornu.png | bin | 4346 -> 1417 bytes | |||
-rw-r--r-- | app/doc/png.d/bcurve.png | bin | 386 -> 1342 bytes | |||
-rw-r--r-- | app/doc/png.d/bcurve1.png | bin | 336 -> 1246 bytes | |||
-rw-r--r-- | app/doc/png.d/bcurve2.png | bin | 354 -> 1234 bytes | |||
-rw-r--r-- | app/doc/png.d/bcurve3.png | bin | 342 -> 1331 bytes | |||
-rw-r--r-- | app/doc/png.d/bcurve4.png | bin | 355 -> 1414 bytes | |||
-rw-r--r-- | app/doc/png.d/bcurvelin.png | bin | 0 -> 744 bytes | |||
-rw-r--r-- | app/doc/png.d/bdelete.png | bin | 603 -> 863 bytes | |||
-rw-r--r-- | app/doc/png.d/bdescrib.png | bin | 292 -> 811 bytes | |||
-rw-r--r-- | app/doc/png.d/bdraw.png | bin | 689 -> 1988 bytes | |||
-rw-r--r-- | app/doc/png.d/bdrawsplit.png | bin | 0 -> 605 bytes | |||
-rw-r--r-- | app/doc/png.d/beasement.png | bin | 689 -> 399 bytes | |||
-rw-r--r-- | app/doc/png.d/belev.png | bin | 296 -> 898 bytes | |||
-rw-r--r-- | app/doc/png.d/bexport.png | bin | 0 -> 439 bytes | |||
-rw-r--r-- | app/doc/png.d/bexportbmap.png | bin | 0 -> 1298 bytes | |||
-rw-r--r-- | app/doc/png.d/bexportdxf.png | bin | 0 -> 654 bytes | |||
-rw-r--r-- | app/doc/png.d/bexportsvg.png | bin | 0 -> 1274 bytes | |||
-rw-r--r-- | app/doc/png.d/bezier.png | bin | 3866 -> 1359 bytes | |||
-rw-r--r-- | app/doc/png.d/bfile.png | bin | 681 -> 801 bytes | |||
-rw-r--r-- | app/doc/png.d/bflip.png | bin | 267 -> 767 bytes | |||
-rw-r--r-- | app/doc/png.d/bgsnap.png | bin | 372 -> 2304 bytes | |||
-rw-r--r-- | app/doc/png.d/bgundo.png | bin | 303 -> 1352 bytes | |||
-rw-r--r-- | app/doc/png.d/bgzoom.png | bin | 511 -> 2140 bytes | |||
-rw-r--r-- | app/doc/png.d/bhelix.png | bin | 237 -> 1436 bytes | |||
-rw-r--r-- | app/doc/png.d/bhndldto.png | bin | 285 -> 932 bytes | |||
-rw-r--r-- | app/doc/png.d/bimport.png | bin | 0 -> 457 bytes | |||
-rw-r--r-- | app/doc/png.d/bimportmod.png | bin | 0 -> 463 bytes | |||
-rw-r--r-- | app/doc/png.d/bitmap.png | bin | 7090 -> 7777 bytes | |||
-rw-r--r-- | app/doc/png.d/bjoin.png | bin | 4433 -> 1060 bytes | |||
-rw-r--r-- | app/doc/png.d/bjoinline.png | bin | 4329 -> 733 bytes | |||
-rw-r--r-- | app/doc/png.d/blayer.png | bin | 70247 -> 2835 bytes | |||
-rw-r--r-- | app/doc/png.d/blink.png | bin | 626 -> 776 bytes | |||
-rw-r--r-- | app/doc/png.d/bmap.png | bin | 353 -> 357 bytes | |||
-rw-r--r-- | app/doc/png.d/bmcircle.png | bin | 1831 -> 1225 bytes | |||
-rw-r--r-- | app/doc/png.d/bmcurved.png | bin | 2283 -> 2246 bytes | |||
-rw-r--r-- | app/doc/png.d/bmenu.png | bin | 485 -> 339 bytes | |||
-rw-r--r-- | app/doc/png.d/bmodify.png | bin | 328 -> 1169 bytes | |||
-rw-r--r-- | app/doc/png.d/bmove.png | bin | 319 -> 784 bytes | |||
-rw-r--r-- | app/doc/png.d/bmovedes.png | bin | 377 -> 845 bytes | |||
-rw-r--r-- | app/doc/png.d/bnew.png | bin | 793 -> 427 bytes | |||
-rw-r--r-- | app/doc/png.d/bnewcar.png | bin | 367 -> 561 bytes | |||
-rw-r--r-- | app/doc/png.d/bnote.png | bin | 600 -> 507 bytes | |||
-rw-r--r-- | app/doc/png.d/bopen.png | bin | 889 -> 743 bytes | |||
-rw-r--r-- | app/doc/png.d/bparallel.png | bin | 4402 -> 802 bytes | |||
-rw-r--r-- | app/doc/png.d/bparalleline.png | bin | 4357 -> 721 bytes | |||
-rw-r--r-- | app/doc/png.d/bparam.png | bin | 0 -> 772 bytes | |||
-rw-r--r-- | app/doc/png.d/bprint.png | bin | 0 -> 450 bytes | |||
-rw-r--r-- | app/doc/png.d/brevert.png | bin | 0 -> 694 bytes | |||
-rw-r--r-- | app/doc/png.d/broadbed.png | bin | 0 -> 841 bytes | |||
-rw-r--r-- | app/doc/png.d/brotate.png | bin | 345 -> 1117 bytes | |||
-rw-r--r-- | app/doc/png.d/bruler.png | bin | 255 -> 674 bytes | |||
-rw-r--r-- | app/doc/png.d/bsave.png | bin | 938 -> 636 bytes | |||
-rw-r--r-- | app/doc/png.d/bsaveas.png | bin | 0 -> 839 bytes | |||
-rw-r--r-- | app/doc/png.d/bselect.png | bin | 282 -> 687 bytes | |||
-rw-r--r-- | app/doc/png.d/bsensor.png | bin | 563 -> 1224 bytes | |||
-rw-r--r-- | app/doc/png.d/bsetup.png | bin | 0 -> 420 bytes | |||
-rw-r--r-- | app/doc/png.d/bsignal.png | bin | 581 -> 581 bytes | |||
-rw-r--r-- | app/doc/png.d/bsplit.png | bin | 286 -> 919 bytes | |||
-rw-r--r-- | app/doc/png.d/bstraigh.png | bin | 285 -> 1100 bytes | |||
-rw-r--r-- | app/doc/png.d/bstruct.png | bin | 289 -> 777 bytes | |||
-rw-r--r-- | app/doc/png.d/bswitchmotor.png | bin | 679 -> 805 bytes | |||
-rw-r--r-- | app/doc/png.d/btext.png | bin | 241 -> 670 bytes | |||
-rw-r--r-- | app/doc/png.d/bties.png | bin | 0 -> 727 bytes | |||
-rw-r--r-- | app/doc/png.d/btop_bottom.png | bin | 705 -> 837 bytes | |||
-rw-r--r-- | app/doc/png.d/btrain.png | bin | 273 -> 883 bytes | |||
-rw-r--r-- | app/doc/png.d/btunnel.png | bin | 245 -> 652 bytes | |||
-rw-r--r-- | app/doc/png.d/bturnout.png | bin | 278 -> 897 bytes | |||
-rw-r--r-- | app/doc/png.d/bturntbl.png | bin | 282 -> 1151 bytes | |||
-rw-r--r-- | app/doc/png.d/cgroup.png | bin | 7967 -> 32372 bytes | |||
-rw-r--r-- | app/doc/png.d/cmdopt.png | bin | 7407 -> 20629 bytes | |||
-rw-r--r-- | app/doc/png.d/colorw.png | bin | 8380 -> 5299 bytes | |||
-rw-r--r-- | app/doc/png.d/convertfrom.png | bin | 4169 -> 874 bytes | |||
-rw-r--r-- | app/doc/png.d/convertto.png | bin | 4169 -> 814 bytes | |||
-rw-r--r-- | app/doc/png.d/dbench.png | bin | 289 -> 691 bytes | |||
-rw-r--r-- | app/doc/png.d/dbezier.png | bin | 3776 -> 837 bytes | |||
-rw-r--r-- | app/doc/png.d/dbox.png | bin | 271 -> 570 bytes | |||
-rw-r--r-- | app/doc/png.d/dcircle1.png | bin | 0 -> 1078 bytes | |||
-rw-r--r-- | app/doc/png.d/dcircle2.png | bin | 296 -> 908 bytes | |||
-rw-r--r-- | app/doc/png.d/dcircle3.png | bin | 296 -> 886 bytes | |||
-rw-r--r-- | app/doc/png.d/dcurve1.png | bin | 280 -> 728 bytes | |||
-rw-r--r-- | app/doc/png.d/dcurve2.png | bin | 295 -> 793 bytes | |||
-rw-r--r-- | app/doc/png.d/dcurve3.png | bin | 288 -> 780 bytes | |||
-rw-r--r-- | app/doc/png.d/dcurve4.png | bin | 302 -> 801 bytes | |||
-rw-r--r-- | app/doc/png.d/ddimlin.png | bin | 284 -> 802 bytes | |||
-rw-r--r-- | app/doc/png.d/dentermove.png | bin | 0 -> 2592 bytes | |||
-rw-r--r-- | app/doc/png.d/dfilbox.png | bin | 262 -> 573 bytes | |||
-rw-r--r-- | app/doc/png.d/dfilpoly.png | bin | 316 -> 852 bytes | |||
-rw-r--r-- | app/doc/png.d/dflcrcl2.png | bin | 303 -> 1022 bytes | |||
-rw-r--r-- | app/doc/png.d/dflcrcl3.png | bin | 297 -> 983 bytes | |||
-rw-r--r-- | app/doc/png.d/displayopt.png | bin | 86476 -> 80557 bytes | |||
-rw-r--r-- | app/doc/png.d/dlayer.png | bin | 9268 -> 0 bytes | |||
-rw-r--r-- | app/doc/png.d/dlayers.png | bin | 8594 -> 51754 bytes | |||
-rw-r--r-- | app/doc/png.d/dline.png | bin | 260 -> 444 bytes | |||
-rw-r--r-- | app/doc/png.d/dpoly.png | bin | 313 -> 722 bytes | |||
-rw-r--r-- | app/doc/png.d/dpolylin.png | bin | 0 -> 716 bytes | |||
-rw-r--r-- | app/doc/png.d/dprmfile.png | bin | 13308 -> 11394 bytes | |||
-rw-r--r-- | app/doc/png.d/dtbledge.png | bin | 270 -> 631 bytes | |||
-rw-r--r-- | app/doc/png.d/exportfile.png | bin | 22136 -> 28238 bytes | |||
-rw-r--r-- | app/doc/png.d/exportfiledxf.png | bin | 19413 -> 24605 bytes | |||
-rw-r--r-- | app/doc/png.d/exportfilesvg.png | bin | 0 -> 29333 bytes | |||
-rw-r--r-- | app/doc/png.d/iconlink.png (renamed from app/doc/png.d/iconlink.PNG) | bin | 230 -> 230 bytes | |||
-rw-r--r-- | app/doc/png.d/import.png | bin | 22302 -> 22986 bytes | |||
-rw-r--r-- | app/doc/png.d/importmod.png | bin | 0 -> 22835 bytes | |||
-rw-r--r-- | app/doc/png.d/layout.png | bin | 72958 -> 39585 bytes | |||
-rw-r--r-- | app/doc/png.d/madd.png | bin | 13693 -> 3174 bytes | |||
-rw-r--r-- | app/doc/png.d/maddcircle.png | bin | 0 -> 1812 bytes | |||
-rw-r--r-- | app/doc/png.d/maddcontrol.png | bin | 0 -> 1355 bytes | |||
-rw-r--r-- | app/doc/png.d/maddcurve.png | bin | 0 -> 2394 bytes | |||
-rw-r--r-- | app/doc/png.d/maddparallel.png | bin | 0 -> 1247 bytes | |||
-rw-r--r-- | app/doc/png.d/map.png | bin | 3868 -> 1430 bytes | |||
-rw-r--r-- | app/doc/png.d/mchange.png | bin | 23214 -> 5142 bytes | |||
-rw-r--r-- | app/doc/png.d/mconvert.png | bin | 0 -> 1125 bytes | |||
-rw-r--r-- | app/doc/png.d/mdraw.png | bin | 10174 -> 2053 bytes | |||
-rw-r--r-- | app/doc/png.d/mdrawcircles.png | bin | 2758 -> 1934 bytes | |||
-rw-r--r-- | app/doc/png.d/mdrawcurve.png | bin | 2570 -> 2032 bytes | |||
-rw-r--r-- | app/doc/png.d/mdrawmeasure.png | bin | 0 -> 588 bytes | |||
-rw-r--r-- | app/doc/png.d/mdrawnotes.png | bin | 0 -> 881 bytes | |||
-rw-r--r-- | app/doc/png.d/mdrawshapes.png | bin | 2181 -> 1853 bytes | |||
-rw-r--r-- | app/doc/png.d/mdrawstraight.png | bin | 2233 -> 1818 bytes | |||
-rw-r--r-- | app/doc/png.d/medit.png | bin | 7035 -> 6233 bytes | |||
-rw-r--r-- | app/doc/png.d/mentermove.png | bin | 0 -> 6641 bytes | |||
-rw-r--r-- | app/doc/png.d/mfile.png | bin | 6016 -> 7770 bytes | |||
-rw-r--r-- | app/doc/png.d/mhelp.png | bin | 2251 -> 4789 bytes | |||
-rw-r--r-- | app/doc/png.d/mhelpdemos.png | bin | 4031 -> 3407 bytes | |||
-rw-r--r-- | app/doc/png.d/mjoin.png | bin | 0 -> 978 bytes | |||
-rw-r--r-- | app/doc/png.d/mmacro.png | bin | 1203 -> 941 bytes | |||
-rw-r--r-- | app/doc/png.d/mmanage.png | bin | 8632 -> 4331 bytes | |||
-rw-r--r-- | app/doc/png.d/mmanageturnoutdesign.png | bin | 3742 -> 3271 bytes | |||
-rw-r--r-- | app/doc/png.d/moptions.png | bin | 3378 -> 2285 bytes | |||
-rw-r--r-- | app/doc/png.d/mselect.png | bin | 4055 -> 0 bytes | |||
-rw-r--r-- | app/doc/png.d/mselectcmd.png | bin | 0 -> 78701 bytes | |||
-rw-r--r-- | app/doc/png.d/mselectcontext.png | bin | 0 -> 47076 bytes | |||
-rw-r--r-- | app/doc/png.d/mselected.png | bin | 5004 -> 0 bytes | |||
-rw-r--r-- | app/doc/png.d/mselectedcontext.png | bin | 0 -> 68960 bytes | |||
-rw-r--r-- | app/doc/png.d/msplit.png | bin | 0 -> 1399 bytes | |||
-rw-r--r-- | app/doc/png.d/mview.png | bin | 15591 -> 4108 bytes | |||
-rw-r--r-- | app/doc/png.d/pan.png | bin | 3929 -> 788 bytes | |||
-rw-r--r-- | app/doc/png.d/paramsearch.png | bin | 14516 -> 34767 bytes | |||
-rw-r--r-- | app/doc/png.d/pref.png | bin | 12308 -> 46567 bytes | |||
-rw-r--r-- | app/doc/png.d/problemdata.png | bin | 0 -> 9536 bytes | |||
-rw-r--r-- | app/doc/png.d/statusbarparallel.png | bin | 12964 -> 4002 bytes | |||
-rw-r--r-- | app/doc/png.d/statustext.png | bin | 1681 -> 3860 bytes | |||
-rw-r--r-- | app/doc/png.d/sticky.png | bin | 12075 -> 8324 bytes | |||
-rw-r--r-- | app/doc/png.d/turnsel.png | bin | 18373 -> 50207 bytes | |||
-rw-r--r-- | app/doc/view_winm.but | 53 | ||||
-rw-r--r-- | app/doc/warranty.but | 142 | ||||
-rw-r--r-- | app/doc/xtrkcad-manual-5.3.0.html | 19625 |
173 files changed, 21290 insertions, 661 deletions
diff --git a/app/doc/CMakeLists.txt b/app/doc/CMakeLists.txt index adc21b3..65f5b70 100644 --- a/app/doc/CMakeLists.txt +++ b/app/doc/CMakeLists.txt @@ -1,12 +1,21 @@ -PROJECT(doc) +project(doc) -CONFIGURE_FILE(${CMAKE_CURRENT_SOURCE_DIR}/intro.but.in ${CMAKE_CURRENT_BINARY_DIR}/intro.but) -CONFIGURE_FILE(${CMAKE_CURRENT_SOURCE_DIR}/clean-html.cmake.in ${CMAKE_CURRENT_BINARY_DIR}/clean-html.cmake @ONLY) -CONFIGURE_FILE(${CMAKE_CURRENT_SOURCE_DIR}/hhc.cmake.in ${CMAKE_CURRENT_BINARY_DIR}/hhc.cmake @ONLY) +configure_file(${CMAKE_CURRENT_SOURCE_DIR}/intro.but.in ${CMAKE_CURRENT_BINARY_DIR}/intro.but) +configure_file(${CMAKE_CURRENT_SOURCE_DIR}/hhc.cmake.in ${CMAKE_CURRENT_BINARY_DIR}/hhc.cmake @ONLY) -FILE(MAKE_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}/html) +# +# Create directory for the html stage -SET(HALIBUT_SOURCES +file(MAKE_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}/html) + +add_custom_target(helpsystem) +set_target_properties( + helpsystem + PROPERTIES FOLDER HelpDocs +) + +target_sources(helpsystem + PRIVATE ${CMAKE_CURRENT_BINARY_DIR}/intro.but ${CMAKE_CURRENT_SOURCE_DIR}/addm.but ${CMAKE_CURRENT_SOURCE_DIR}/changem.but @@ -22,97 +31,137 @@ SET(HALIBUT_SOURCES ${CMAKE_CURRENT_SOURCE_DIR}/view_winm.but ${CMAKE_CURRENT_SOURCE_DIR}/navigation.but ${CMAKE_CURRENT_SOURCE_DIR}/appendix.but - ${help_BINARY_DIR}/messages.but + ${messagefile_BINARY_DIR}/messages.but ${CMAKE_CURRENT_SOURCE_DIR}/upgrade.but ${CMAKE_CURRENT_SOURCE_DIR}/warranty.but - ) +) + +# +# messages.but is generated in a different directory scope, CMake must not check for existance +set_source_files_properties(${messagefile_BINARY_DIR}/messages.but + PROPERTIES + GENERATED True) # Add a custom command for cleaning the HTML staging directory -ADD_CUSTOM_TARGET(clean-html +add_custom_target(clean-html WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}/html - COMMAND ${CMAKE_COMMAND} -P ${CMAKE_CURRENT_BINARY_DIR}/clean-html.cmake - ) + COMMAND ${CMAKE_COMMAND} -P ${CMAKE_CURRENT_SOURCE_DIR}/clean-html.cmake +) # If we're using the GTK back-end, just generate "vanilla" HTML help files for use with gtkhtml -IF(XTRKCAD_USE_GTK) +if(XTRKCAD_USE_GTK) + + if (APPLE) + target_sources(helpsystem + PRIVATE + ${CMAKE_CURRENT_SOURCE_DIR}/osxconf.but) + else() + target_sources(helpsystem + PRIVATE + ${CMAKE_CURRENT_SOURCE_DIR}/linconf.but) + endif() - IF (APPLE) - SET(HALIBUT_SOURCES ${CMAKE_CURRENT_SOURCE_DIR}/osxconf.but ${HALIBUT_SOURCES}) - ELSE(APPLE) - SET(HALIBUT_SOURCES ${CMAKE_CURRENT_SOURCE_DIR}/linconf.but ${HALIBUT_SOURCES}) - ENDIF(APPLE) + get_target_property(halibut_sources helpsystem SOURCES) - ADD_CUSTOM_COMMAND( + add_custom_command( OUTPUT ${CMAKE_CURRENT_BINARY_DIR}/html/index.html - DEPENDS halibut ${HALIBUT_SOURCES} + DEPENDS halibut ${halibut_sources} WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}/html - COMMAND ${CMAKE_COMMAND} -P ${CMAKE_CURRENT_BINARY_DIR}/clean-html.cmake - COMMAND halibut ${HALIBUT_SOURCES} + COMMAND ${CMAKE_COMMAND} -P ${CMAKE_CURRENT_SOURCE_DIR}/clean-html.cmake + COMMAND halibut ${halibut_sources} ) - ADD_CUSTOM_TARGET(help-html ALL DEPENDS ${CMAKE_CURRENT_BINARY_DIR}/html/index.html) + add_custom_target(help-html ALL DEPENDS ${CMAKE_CURRENT_BINARY_DIR}/html/index.html msgfiles) - INSTALL( + install( DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}/html DESTINATION ${XTRKCAD_SHARE_INSTALL_DIR} ) - INSTALL( + install( DIRECTORY ${CMAKE_CURRENT_SOURCE_DIR}/png.d DESTINATION ${XTRKCAD_SHARE_INSTALL_DIR}/html ) - INSTALL( + install( FILES xtrkcad_lin.css DESTINATION ${XTRKCAD_SHARE_INSTALL_DIR}/html ) # Copy the help files to the Help bundle if Apple - IF (APPLE) - ADD_CUSTOM_COMMAND( - OUTPUT ${CMAKE_CURRENT_BINARY_DIR}/html/XTrackCAD.helpindex - DEPENDS help-html ${HALIBUT_SOURCES} - WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}/html - COMMAND hiutil -Cf XTrackCAD.helpindex -gva -e "IndexPage.html" -e "toc.html" ${CMAKE_CURRENT_BINARY_DIR}/html + if (APPLE) + add_custom_command( + OUTPUT ${CMAKE_CURRENT_BINARY_DIR}/html/XTrackCAD.helpindex + DEPENDS help-html ${halibut_sources} + WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}/html + COMMAND hiutil -Cf XTrackCAD.helpindex -gva -e "IndexPage.html" -e "toc.html" ${CMAKE_CURRENT_BINARY_DIR}/html ) - ADD_CUSTOM_TARGET(help-index ALL DEPENDS ${CMAKE_CURRENT_BINARY_DIR}/html/XTrackCAD.helpindex) + add_custom_target(help-index ALL DEPENDS ${CMAKE_CURRENT_BINARY_DIR}/html/XTrackCAD.helpindex) - INSTALL( + install( DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}/html/ DESTINATION ${XTRKCAD_SHARE_INSTALL_DIR}/XTrackCAD.help/Contents/Resources/en.lproj ) - INSTALL( + install( DIRECTORY ${CMAKE_CURRENT_SOURCE_DIR}/png.d DESTINATION ${XTRKCAD_SHARE_INSTALL_DIR}/XTrackCAD.help/Contents/Resources/en.lproj ) - INSTALL( + install( FILES xtrkcad_osx.css DESTINATION ${XTRKCAD_SHARE_INSTALL_DIR}/XTrackCAD.help/Contents/Resources/en.lproj/sty ) - ENDIF(APPLE) + endif() # Otherwise, we're using the Win32 back-end, so generate a compiled HTML help file -ELSE(XTRKCAD_USE_GTK) +else() + find_package(HTMLHelp) - SET(HALIBUT_SOURCES ${CMAKE_CURRENT_SOURCE_DIR}/chmconf.but ${HALIBUT_SOURCES}) - FILE(GLOB IMAGE_SOURCES png.d/*) - - ADD_CUSTOM_COMMAND( - OUTPUT ${CMAKE_CURRENT_BINARY_DIR}/html/xtrkcad.chm - DEPENDS halibut ${HALIBUT_SOURCES} ${IMAGE_SOURCES} ${CMAKE_CURRENT_SOURCE_DIR}/xtrkcad_win.css - WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}/html - COMMAND ${CMAKE_COMMAND} -P ${CMAKE_CURRENT_BINARY_DIR}/clean-html.cmake - COMMAND ${CMAKE_COMMAND} -E copy_directory ${CMAKE_CURRENT_SOURCE_DIR}/png.d ${CMAKE_CURRENT_BINARY_DIR}/html/png.d - COMMAND ${CMAKE_COMMAND} -E copy ${CMAKE_CURRENT_SOURCE_DIR}/xtrkcad_win.css ${CMAKE_CURRENT_BINARY_DIR}/html - COMMAND halibut ${HALIBUT_SOURCES} - COMMAND ${CMAKE_COMMAND} -P ${CMAKE_CURRENT_BINARY_DIR}/hhc.cmake + if("${HTML_HELP_COMPILER}" STRGREATER "") + target_sources(helpsystem + PRIVATE + ${CMAKE_CURRENT_SOURCE_DIR}/chmconf.but + ) + file(GLOB IMAGE_SOURCES ${CMAKE_CURRENT_SOURCE_DIR}/png.d/*) + + # + # Use the Microsoft HTML Help Workshop to create a chm file + # + # Clean the working directory + # Copy the image files and the CSS + # Create the sources for the Help Workshop using halibut + # Build the chm file + # Add the chm file to the installation + + add_custom_target(help-chm ALL DEPENDS ${halibut_sources}) + set_target_properties( + help-chm + PROPERTIES FOLDER HelpDocs ) - - ADD_CUSTOM_TARGET(help-chm ALL DEPENDS ${CMAKE_CURRENT_BINARY_DIR}/html/xtrkcad.chm) - - INSTALL( - FILES ${CMAKE_CURRENT_BINARY_DIR}/html/xtrkcad.chm - DESTINATION ${XTRKCAD_SHARE_INSTALL_DIR} + get_target_property(halibut_sources helpsystem SOURCES) + + # hhc exits with non-zero code even on success + # workaround is to create an external cmake script that + # invokes hhc and handle its specific exit code + configure_file("${CMAKE_CURRENT_SOURCE_DIR}/hhc.cmake.in" + "${CMAKE_CURRENT_BINARY_DIR}/hhc.cmake" + @ONLY) + + add_custom_command( + TARGET help-chm + DEPENDS halibut helpsystem ${IMAGE_SOURCES} ${CMAKE_CURRENT_SOURCE_DIR}/xtrkcad_win.css + WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}/html + COMMAND ${CMAKE_COMMAND} -P ${CMAKE_CURRENT_SOURCE_DIR}/clean-html.cmake + COMMAND ${CMAKE_COMMAND} -E copy_directory ${CMAKE_CURRENT_SOURCE_DIR}/png.d ${CMAKE_CURRENT_BINARY_DIR}/html/png.d + COMMAND ${CMAKE_COMMAND} -E copy ${CMAKE_CURRENT_SOURCE_DIR}/xtrkcad_win.css ${CMAKE_CURRENT_BINARY_DIR}/html + COMMAND halibut ${halibut_sources} + COMMAND ${CMAKE_COMMAND} -P ${CMAKE_CURRENT_BINARY_DIR}/hhc.cmake ) -ENDIF(XTRKCAD_USE_GTK) + install( + FILES ${CMAKE_CURRENT_BINARY_DIR}/html/xtrkcad.chm + DESTINATION ${XTRKCAD_SHARE_INSTALL_DIR} + ) + else() + message(STATUS "HTML Help Workshop not found! CHM Help will not be created.") + endif() +endif() diff --git a/app/doc/addm.but b/app/doc/addm.but index f2caf26..a705a26 100644 --- a/app/doc/addm.but +++ b/app/doc/addm.but @@ -16,253 +16,295 @@ The \f{Add Menu} has all the actions related to adding track pieces to the layout. -\dd \f{Circle Track} - place a circle of track by selecting radius, tangent and or center (\K{cmdCircle}). +\dd \i{Straight Track} \c{Ctrl+G} - lay straight track pieces of arbitrary lengths \u000 -\dd \f{Curved Track} - lay curved track pieces using different modes for selecting start and endpoints and radius (\K{cmdCurve}). +\dd \i{Curve Track} - lay curved track pieces using different modes for selecting start and endpoints and radius (\K{cmdCurve}). + +\dd \G{png.d/maddcurve.png} \u000 -\dd \f{Hand-laid Turnout} - lay a turnout in place on the layout. (\K{cmdHandLaidTurnout}) +\dd \i{Circle Track} \I{Track, Circle} - place a circle of track by selecting radius, tangent and or center (\K{cmdCircle}). + +\dd \G{png.d/maddcircle.png} \u000 -\dd \f{Helix} - Add a helix. (\K{cmdHelix}) +\dd \i{Parallel} - \I{Parallel Track} \I{Track, Parallel} \I{Parallel Line} \I{Line, Parallel} +create parallel track or line to existing flex-track, straight or curved track. (\K{cmdParallel}) + +\dd \G{png.d/maddparallel.png} \u000 -\dd \f{Parallel} - create parallel track or line to existing flex-track, straight or curved track. (\K{cmdParallel}) +\dd \i{Fixed-track} \I{Track, Fixed} \c{Ctrl+T} - select a piece of \f{Fixed-track} and place on layout. \u000 -\dd \f{Straight Track} - lay straight track pieces of arbitrary lengths +\dd \i{Hand-laid Turnout} \I{Turnout, Hand-laid} \c{Ctrl+Shift+I} - lay a turnout in place on the layout. (\K{cmdHandLaidTurnout}) \u000 -\dd \f{Structure} - Add a predefined structure to the layout. +\dd \i{Structure} \c{Ctrl+Shift+C} - Add a predefined structure to the layout. \u000 -\dd \f{Predefined Track} - select a turnout or a piece of fixed track and place on layout. +\dd \i{Helix} \c{Ctrl+Shift+H} - Add a helix. (\K{cmdHelix}) \u000 -\dd \f{Custom Turntable} - Place a turntable. (\K{cmdTurntable}) +\dd \i{Custom Turntable} \I{Turntable, Custom} \c{Ctrl+Shift+N} - Place a turntable. (\K{cmdTurntable}) \u000 -\dd \f{Block} - Create a block. (\K{cmdBlock}) +\dd \i{Control Element} - Create a control element. \u000 -\dd \f{Switchmotor} - Create a switchmotor. (\K{cmdSwitchmotor}) +\dd \i{Block} \I{Control Element, Block} - Create a block. (\K{cmdBlock}) \u000 -\dd \f{Signal} - Create a signal. (\K{cmdSignal}) +\dd \i{Switchmotor} \I{Control Element, Switchmotor} - Create a switchmotor. (\K{cmdSwitchmotor}) \u000 -\dd \f{Control} - Create a control. (\K{cmdControl}) +\dd \i{Signal} \I{Control Element, Signal} - Create a signal. (\K{cmdSignal}) \u000 -\dd \f{Sensor} - Create a sensor. (\K{cmdSensor}) +\dd \i{Control} \I{Control Element, Control} - Create a control. (\K{cmdControl}) -\S{cmdCircle} Circle Track +\u000 -\G{png.d/bcircle.png} +\dd \i{Sensor} \I{Control Element, Sensor} - Create a sensor. (\K{cmdSensor}) -A circle track is a special form of a curved track that extends 360\u00B0 and has no endpoints. The three methods (with their Shortcut keys) used to create a Circle Track are: +\rule -\u000 +\S{cmdCircle} \i{Circle Track} -\dd (\K{cmdCircleFixedRadius}). Use the Fixed Radius specified on the \e{Circle Radius} control displayed on the Status Bar (\K{mainW}). -\c{Left-Drag} the Circle track into position. +\G{png.d/maddcircle.png} -\u000 +A circle track \I{Circle Track} \I{Track, Circle} is a special form of a curved track that extends 360\u00B0 and has no endpoints. +The drop down menu, which allows selection of the Circle Track creation method, is invoked from the down arrow button located on the right side the Circle track button. -\dd (\K{cmdCircleTangent}). \c{Left-Drag} from tangent point (Edge) of the Circle track to the Center. +\dd \G{png.d/bcircle.png} + +\dd \G{png.d/bmcircle.png} + +\dd \e{Circle Track Button Menu} + +The three methods (with their Icons and Shortcut keys) used to create a Circle Track are: \u000 -\dd (\K{cmdCircleCenter}). \c{Left-Drag} from the Center of the Circle track to the edge. +\dd \G{png.d/bcircl1.png} (\K{cmdCircleFixedRadius}) \c{Control+8} - Use the Fixed Radius specified on the \i\e{Circle Radius} +control displayed on the Status Bar (\K{mainW}). \c{Left-Drag} the Circle track into position. \u000 -A drop down menu, which allows selection of the Circle Track creation method, is invoked from the down arrow button (\G{png.d/bmenu.png}) located on the right side the Circle track button. -Dependent upon previous selection, the Circle Track button will look like \G{png.d/bcircl1.png}, \G{png.d/bcircl2.png} or \G{png.d/bcircl3.png}. +\dd \G{png.d/bcircl2.png} (\K{cmdCircleTangent}) \c{Control+9} - \c{Left-Drag} from tangent point (Edge) of the Circle track to the Center. -\dd \G{png.d/bmcircle.png} +\u000 -\dd \e{Circle Track Button Menu} +\dd \G{png.d/bcircl3.png} (\K{cmdCircleCenter}) \c{Control+0} - \c{Left-Drag} from the Center of the Circle track to the edge. + +\u000 If Snap Grid (\K{cmdGrid}) is enabled then circle centers will be constrained to the grid. -Circle tracks are useful for fitting curves into corners and other tight places. They're also handy when establishing an initial layout and finding out "what will fit". +Circle tracks are useful for fitting curves into corners and other tight places. They're also handy when establishing an +initial layout and finding out "what will fit". You can join to and from circles, after which they become curved tracks. \rule -\S2{cmdCircleFixedRadius} Circle Fixed Radius +\S2{cmdCircleFixedRadius} \i{Circle Fixed Radius} \G{png.d/bcircl1.png} -(\c{Control-8}) Use the Fixed Radius specified on the \e{Circle Radius} control displayed on the Status Bar (\K{mainW}). -\c{Left-Drag} the Circle track into position. +(\c{Ctrl+8}) Use the Fixed Radius specified on the \i\e{Circle Radius} control displayed on the Status Bar (\K{mainW}). +\c{Left-Drag} the Circle track into position. \rule -\S2{cmdCircleTangent} Circle Fixed Tangent +\S2{cmdCircleTangent} \i{Circle Fixed Tangent} \G{png.d/bcircl2.png} -(\c{Control-9}) \c{Left-Drag} from tangent point (Edge) of the Circle track to the Center. +(\c{Ctrl+9}) \c{Left-Drag} from tangent point (Edge) of the Circle track to the Center. \rule -\S2{cmdCircleCenter} Circle From Center +\S2{cmdCircleCenter} \i{Circle From Center} \G{png.d/bcircl3.png} -(\c{Control-0}) \c{Left-Drag} from the Center of the Circle track to the edge. +(\c{Ctrl+0}) \c{Left-Drag} from the Center of the Circle track to the edge. \rule -\S{cmdCurve} Curved Track +\S{cmdCurve} \i{Curved Track} -\G{png.d/bcurve.png} +\G{png.d/maddcurve.png} -Creating a curve is a two step operation. +Creating a curve is a two step operation. You will select a point and then \c{Left-Drag} to specify the control point depending on the drawing method. -The five methods (with their Shortcut keys) used to create a Curved Track are: +A drop-down menu, which allows selection of the Curved Track creation method, is invoked from the down arrow button +located on the right side the Curved track button. + +\dd \G{png.d/bcurve.png} + +\dd \G{png.d/bmcurved.png} + +\dd \e{Curved Track Button Menu} + +The six methods (with their Shortcut keys) used to create a Curved Track are: \dd -\dd \K{cmdCurveEndPt}. Drag out the end and then set its radius by dragging the endpoint. +\dd \G{png.d/bcurve1.png} \K{cmdCurveEndPt} \c{Control+4} - \I{End Point, Curved Track} \I{Curved Track, End Point} +Drag out the end and then set its radius by dragging the endpoint. \u000 -\dd \K{cmdCurveTangent}. Drag from the an endpoint to the center and then drag the second enpoint around that center. +\dd \G{png.d/bcurve2.png} \K{cmdCurveTangent} \c{Control+5} - \I{Tangent, Curved Track} \I{Curved Track, Tangent} +Drag from the an endpoint to the center and then drag the second enpoint around that center. \u000 -\dd \K{cmdCurveCenter}. Drag from the Center of the Curved track to one of the endpoints. Position the second endpoint around the center. +\dd \G{png.d/bcurve3.png} \K{cmdCurveCenter} \c{Control+6} - \I{Center, Curved Track} \I{Curved Track, Center} +Drag from the Center of the Curved track to one of the endpoints. Position the second endpoint around the center. \u000 -\dd \K{cmdCurveChord}. Drag from one endpoint to the other endpoint to form the Chord of the Curve. Drag the arc out to form the Curve. +\dd \G{png.d/bcurve4.png} \K{cmdCurveChord} \c{Control+7} - \I{Chord, Curved Track} \I{Curved Track, Chord} +Drag from one endpoint to the other endpoint to form the Chord of the Curve. Drag the arc out to form the Curve. \u000 -\dd \K{cmdBezier}. Construct a Bezier by placing its four control points. +\dd \G{png.d/bezier.png} \K{cmdBezier} - Construct a \i{Bezier Track} \I{Track, Bezier} by placing its four control points. \u000 -A drop-down menu, which allows selection of the Curved Track creation method, is invoked from the down arrow button (\G{png.d/bmenu.png}) located on the right side the Curved track button. Dependent upon previous selection, the Curved Track button will look like \G{png.d/bcurve1.png}, \G{png.d/bcurve2.png}, \G{png.d/bcurve3.png}, \G{png.d/bcurve4.png}, \G{png.d/bezier.png} or \G{png.d/bcornu.png}. +\dd \G{png.d/bcornu.png} \K{cmdCornu} - Construct a \i{Cornu Track} \I{Track, Cornu} curve by selecting the end points and dragging to set the curve values. -\dd \G{png.d/bmcurved.png} +\u000 -\dd \e{Curved Track Button Menu} +For the first four curve mthods, two Red arrow heads will be drawn after the first step to indicate where you can \c{Left-Drag} to complete the second step. -For all but the Bezier Curve, two Red arrow heads will be drawn after the first step to indicate where you can \c{Left-Drag} to complete the second step. +A straight track will be created if the second endpoint is lined up with the first endpoint except for Bezier and Cornu tracks. -A straight track will be created if the second endpoint is lined up with the first endpoint except for Bezier tracks. +The radius of the curve is designed to be in 1/8" increments unless the \e{desired radius} field is set non-zero and the radius drawn is close to that value, in which case the radius will snap to that value. If the Snap Grid (\K{cmdGrid}) is enabled then the endpoints will be constrained to the grid if they are not snapped to another object. \c{Shift} ensures that other objects will be ignored. Optionally, the curve center point and radius can be displayed for the Curve. This is enabled by the Move Label (\K{cmdMoveLabel}) command. - -For Beziers, the active control point will be drawn in red and the available endpoints are shown with circles. +For Beziers and Cornus, the active control point will be drawn in red and the available endpoints are shown with circles. -\f{Note:} You can also create Straight and Curved tracks using \k{cmdModify} by \c{Left-Drag}ing out extra track from an open end-point. +\f{Note:} You can also create Straight and Curved tracks using \k{cmdModify} by \c{Left-Drag}ging out extra track from an open end-point. \rule -\S2{cmdCurveEndPt} Curved Track from End Point +\S2{cmdCurveEndPt} \i{Curved Track from End Point} + +\G{png.d/bcurve1.png} -\G{png.d/bcurve1.png} +(\c{Ctrl+4}) Drag from one endpoint in the direction of the Curve at that point and release. \c{Left-Drag} the red arrows to position the second endpoint. -(\c{Control-4}) Drag from one endpoint in the direction of the Curve at that point and release. \c{Left-Drag} the red arrows to position the second endpoint. +While the first endpoint is being placed, and \f{MagneticSnap} (\K{cmdMagneticSnap}) is enabled, unless \e{Alt} is held, +if the cursor is on a track, the new curve end will "Snap" to the nearest open track endpoint and you will drag out the second end in aligned to that track, +once you are dragging the second end it will be restricted to an arc that has the same end angle as the first endpoint. +After a track is competed, the new track will be connected to this first track. +This will also happen with \f{MagneticSnap} set off - if \e{Alt} is held. -While the first endpoint is being placed, and \f{MagneticSnap} is enabled, unless \e{Alt} is held, if the cursor is on a track, the new curve end will "Snap" to the nearest open track endpoint and you will drag out the second end in aligned to that track, once you are dragging the second end it will be restricted to an arc that has the same end angle as the first endpoint. After a track is competed, the new track will be connected to this first track. -This will also happen with \f{MagneticSnap} if \e{Alt} is held. +If Magnetic Snap does not find a end, if \f{SnapGrid} is enabled, the ends will snap to the nearest grid point unless \f{Alt} is held. \rule -\S2{cmdCurveTangent} Curved track from Tangent +\S2{cmdCurveTangent} \i{Curved track from Tangent} -\G{png.d/bcurve2.png} +\G{png.d/bcurve2.png} -(\c{Control-5}) Drag from one of the endpoints (which will behave like the first point in "CurvedTrack From End" to the Center of the Curved track and release. +(\c{Ctrl+5}) Drag from one of the endpoints (which will behave like the first point in "CurvedTrack From End" to the Center of the Curved track and release. \c{Left-Drag} on the arrows to position the second endpoint. -While the endpoints are being placed, if \f{MagneticSnap} is enabled, unless \c{Alt} is held down, they will "Snap" to an open track endpoint of the tracks underneath the cursor and you can only drag out the control point aligned to the end of those tracks. +While the endpoints are being placed, if \f{MagneticSnap} (\K{cmdMagneticSnap}) is enabled, unless \c{Alt} is held down, they will "Snap" to an open track endpoint of the tracks underneath the cursor and you can only drag out the control point aligned to the end of those tracks. After the new track is completed, it will be connected to these existing track. If \f{MagneticSnap} is disabled, the snap will only happen if \e{Alt} is held. +If Magnetic Snap does not find a end, if \f{SnapGrid} is enabled, the end will snap to the nearest grid point unless \f{Alt} is held. \rule -\S2{cmdCurveCenter} Curved Track From Center +\S2{cmdCurveCenter} \i{Curved Track From Center} -\G{png.d/bcurve3.png} +\G{png.d/bcurve3.png} -(\c{Control-6}) Drag from the Center of the Curved track to one of the endpoints and release. \c{Left-Drag} to position the second endpoint. +(\c{Ctrl+6}) Drag from the Center of the Curved track to one of the endpoints and release. \c{Left-Drag} to position the second endpoint. -While the endpoints are being placed, if \f{MagneticSnap} is enabled, unless \c{Alt} is held down, they will "Snap" to an open track endpoint of the tracks underneath the cursor and you can only drag out the control point aligned to the end of those tracks. +While the endpoints are being placed, if \f{MagneticSnap} (\K{cmdMagneticSnap}) is enabled, unless \c{Alt} is held down, they will "Snap" to an open track endpoint of the tracks underneath the cursor and you can only drag out the control point aligned to the end of those tracks. After the new track is completed, it will be connected to these existing track. If \f{MagneticSnap} is disabled, the snap will only happen if \e{Alt} is held. +If Magnetic Snap does not find a end, if \f{SnapGrid} is enabled, the end will snap to the nearest grid point unless \f{Alt} is held. \rule -\S2{cmdCurveChord} Curved Track from Chord +\S2{cmdCurveChord} \i{Curved Track from Chord} -\G{png.d/bcurve4.png} (\c{Control-7}) Drag from one endpoint to the other endpoint to form the Chord of the Curve and release. \c{Left-Click} on the center of the track and Drag to form the Curve. +\G{png.d/bcurve4.png} + +(\c{Ctrl+7}) Drag from one endpoint to the other endpoint to form the Chord of the Curve and release. \c{Left-Click} on the center of the track and Drag to form the Curve. The first end point acts like "CurvedTrack From End". If an exitsing track end is selected, the Chord will only move along line orthogonal to the track. -While the endpoints are being placed, if \f{MagneticSnap} is enabled, unless \c{Alt} is held down, they will "Snap" to an open track endpoint of the tracks underneath the cursor and you can only drag out the control point aligned to the end of those tracks. +While the endpoints are being placed, if \f{MagneticSnap} (\K{cmdMagneticSnap}) is enabled, unless \c{Alt} is held down, they will "Snap" to an open track endpoint of the tracks underneath the cursor and you can only drag out the control point aligned to the end of those tracks. After the new track is completed, it will be connected to these existing track. If \f{MagneticSnap} is disabled, the snap will only happen if \e{Alt} is held. +If Magnetic Snap does not find a end, if \f{SnapGrid} is enabled, the end will snap to the nearest grid point unless \f{Alt} is held. \rule -\S2{cmdBezier} Curved Bezier Track +\S2{cmdBezier} \i{Curved Bezier Track} -\G{png.d/bezier.png} +\G{png.d/bezier.png} -\c{Left-Click} to place one endpoint and \c{Left-Drag} out the first control point and release, \c{Left-Click} to place the second Endpoint and \c{Left-Drag} out the second control point and release. -Once all 4 points are placed, you can pick one at a time and drag it to move it. +\c{Left-Click} to place one endpoint and \c{Left-Drag} out the first control point and release, \c{Left-Click} to place the second Endpoint and \c{Left-Drag} out the second control point and release. +Once all 4 points are placed, you can pick one at a time and drag it to move it. Complete the Curve by pressing \c{Enter|, or Reject it with c\{Esc}. -While the endpoints are being placed, if \f{MagneticSnap} is enabled, unless \c{Alt} is held down, they will "Snap" to an open track endpoint of the tracks underneath the cursor and you can only drag out the control point aligned to the end of those tracks. +While the endpoints are being placed, if \f{MagneticSnap} (\K{cmdMagneticSnap}) is enabled, unless \c{Alt} is held down, they will "Snap" to an open track endpoint of the tracks underneath the cursor and you can only drag out the control point aligned to the end of those tracks. After the new track is completed, it will be connected to these existing track. If \f{MagneticSnap} is disabled, the snap will only happen if \e{Alt} is held. +If Magnetic Snap does not find a end, if \f{SnapGrid} is enabled, the end will snap to the nearest grid point unless \f{Alt} is held. \rule -\S{cmdCornu} Create Cornu Track +\S2{cmdCornu} \i{Create Cornu Track} + +\G{png.d/bcornu.png} -\dd \G{png.d/bcornu.png} \c{Left-Click} to place each endpoint on an open track end or just on the layout. -During the move to the click, if \f{MagneticSnap} is enabled, an anchor will show when the cursor is near an open end point. This can be inhibited with \e{Alt}. +\dd \c{Left-Click} to place each endpoint on an open track end or just on the layout. +During the move to the click, if \f{MagneticSnap} (\K{cmdMagneticSnap}) is enabled, an anchor will show when the cursor is near an open end point. This can be inhibited with \e{Alt}. If \f{MagneticSnap} is disabled this will only happen if \e{Alt} is held. +If Magnetic Snap does not find a end, if \f{SnapGrid} is enabled, the end will snap to the nearest grid point unless \f{Alt} is held. -\c{Left-Drag} if the endpoint not on an existing track drags out the end angle of the new track. This is shown by the Cornu endanchor. +\c{Left-Drag} if the endpoint not on an existing track drags out the end angle of the new track. This is shown by the Cornu endanchor. \G{png.d/cornuendanchor.png} -The anchor is only drawn for Cornu ends that are not joined to existing tracks and it shows the position, direction and radius of the track, and has anchors for altering these properties. -When the Cornu is joined to a track, it uses the properties of the end of that track instead. +The anchor is only drawn for Cornu ends that are not joined to existing tracks and it shows the position, direction and radius of the track, and has anchors for altering these properties. +When the Cornu is joined to a track, it uses the properties of the end of that track instead. Anchor point handles are drawn outside the end of the Cornu track to allow track-pins to be edited on the track itself. -\c{Left-Click} to place the second Endpoint either on a track endpoint or not. \c{Left-Drag} sets the second end angle like the first for unconnected end-points. +\c{Left-Click} to place the second Endpoint either on a track endpoint or not. \c{Left-Drag} sets the second end angle like the first for unconnected end-points. Complete the Curve by pressing \c{Enter}, or Reject it with \c{Esc}. The radius and angle of the selected open Cornu end can also be set with text entry boxes in the Status Bar. -When either endpoint is being moved it will "Snap" to an open track endpoint of the tracks underneath the cursor unless \c{Shift} is held. +When either endpoint is being moved it will "Snap" to an open track endpoint of the tracks underneath the cursor unless \c{Shift} is held. You can then only move the endpoint along that track if it is splitable, or in an extension of it. After the new track is completed, it will be connected to these existing tracks. Cornu Track Pins are further explained in \K{joinCornu} - they constrain the Cornu curve to smoothly pass through thier position as well as satisfying the end conditions. You can place them by clicking on the Cornu and select, \e{Drag} to move them around or hit \e{Delete} to remove them. @@ -272,7 +314,7 @@ If the end is not connected, an anchor will enable the end-angle and radius to b \u000 -\S{cmdHandLaidTurnout} Hand-laid Turnouts +\S{cmdHandLaidTurnout} \i{Hand-laid Turnouts} \G{png.d/bhndldto.png} @@ -297,7 +339,9 @@ Note: the drawing is an approximation to show the location of the \e{Points} and \rule -\S{cmdHelix} Helix Track +\S{cmdHelix} \i{Helix Track} + +\G{png.d/bhelix.png} A helix track is used to change the elevation of track in a restricted space. A helix is drawn as a circle of track, but in 3 dimensions it would resemble a cork screw or the pattern of threads on a bolt. @@ -311,6 +355,8 @@ In the case where different parameters could be affected (for instance changing Changing \e{Vertical Separation} affects \e{Turns} which must be an integer value (no fractions), and this in turn affects the \e{Vertical Separation}. When you set \e{Vertical Separation} you are specifying the minimum separation which is adjusted upwards to the actual value. +The separation is rail-head to rail-head and you need to ensure this is enough to provide clearance when track, sleepers, ballast, baseboard/benchwork is included. + Note: only the \e{Radius} and \e{Turns} are used when creating the helix. After joining the helix to other tracks, you will want to establish the heights of the endpoints at each end of the helix. You can use the Elevation (\K{cmdElevation}) command to do this. A helix is placed the same way as a Circle Track (\K{cmdCircle}) with the addition that you specify the number of turns as well the as the radius of the helix. Then the helix is dragged into position on the layout. @@ -319,17 +365,18 @@ You can join to a helix in the same way you join to a circle. However, once joi A label for the helix is drawn at it's the center. If the elevations are set (either by a Defined Elevation point or connecting to a Defined Elevation point) for the two ends of the helix then the label contains the computed grade and vertical separation between layers as well as the number of turns and total length. The label can be moved or turned off by the Move Label (\K{cmdMoveLabel}) command. -\rule -\S{cmdParallel} Parallel Track or Line +\S{cmdParallel} \i{Parallel Track or Line} -You can pick between two Parallel Commands: +\dd \G{png.d/maddparallel.png} -\dd +\rule + +You can pick between two Parallel Commands: \u000 -\dd \K{cmdParallelTrack}. You can create a new track parallel to any straight, curved, bezier, cornu or easement track. +\dd \K{cmdParallelTrack}. You can create a new track parallel to any straight, curved, bezier, cornu or easement track. \u000 @@ -337,16 +384,16 @@ You can pick between two Parallel Commands: \rule -\S2{cmdParallelTrack} Parallel Track +\S2{cmdParallelTrack} \i{Parallel Track} -\G{png.d/bparallel.png} +\G{png.d/bparallel.png} Select the Track you want to parallel with \c{Left-Click}, and the new parallel track will appear beside it. You control which side the new track will be on by \c{Left-Drag}ging the cursor from one side to the other of the selected track before releasing it. \G{png.d/statusbarparallel.png} The \f{Parallel Separation} control (Visible in the Status Bar) displays the intended separation between parallel tracks/line. This value can be changed before selecting a track. The value must be greater than 0.0 if the gauges are equal. - + \b If the gauges are equal, a value of 0.0 means that the rail of the second track is overlaid on the first to simulate dual guage track. The railside that the new track "shares" is set by which side of center the cursor is on when released. The new track will have NoTies set on. @@ -360,12 +407,12 @@ This command is very useful for creating sidings and yards as well as dual track \b No parallel to a turnouts or a non-straight piece of sectional track is created. -\b It is possible to create tracks that abut (the endpoints are very close and aligned). +\b It is possible to create tracks that abut (the endpoints are very close and aligned). These endpoints will be automatically connected. \rule -\S2{cmdParallelLine} Parallel Lines +\S2{cmdParallelLine} \i{Parallel Lines} \G{png.d/bparalleline.png} @@ -375,7 +422,7 @@ Select the Track or Line you want to parallel with \c{Left-Click}, and the new p \rule -\S{cmdStraight} Straight Track +\S{cmdStraight} \i{Straight Track} \G{png.d/bstraigh.png} @@ -387,11 +434,11 @@ If the Snap Grid (\K{cmdGrid}) is enabled then the endpoints will be constrained \rule -\S{cmdStructure} Structure +\S{cmdStructure} \i{Structure} \G{png.d/bstruct.png} -The \f{Structure} command places diagrams of structures (buildings, bridges and other scenic elements) on the layout. The operation is similar to the Turnout (\K{cmdTurnout}) command. +The \f{Structure} command places diagrams of structures (buildings, bridges and other scenic elements) on the layout. The operation is similar to the Fixed-track (\K{cmdNewFixedTrack}) command. \G{png.d/strsel.png} @@ -401,33 +448,33 @@ The \f{Structure Selection} dialog will disappear while dragging on the layout i See the Hot Bar (\K{cmdHotBar}) command for details on placing Structures on the layout. -\f{Structures} are placed on the layout in same way as \f{turnouts} except that there is no \e{Active endpoint} and structures do not align with existing tracks. +\f{Structures} are placed on the layout in same way as \f{Fixed-tracks} except that there is no \e{Active endpoint} and structures do not align with existing tracks. \rule -\S{cmdTurnout} Turnouts +\S{cmdNewFixedTrack} \i{Fixed-track} \G{png.d/bturnout.png} -Turnouts (and sectional track) are created by the \f{Turnout} command \I{Created by Turnout Command}. When you select the turnout command, the \f{Turnout Selection} dialog is displayed which contains a list of available turnouts and sectional track for the current scale (\K{cmdLayout}) and a diagram of the selected turnout. +Fixed-track objects (Turnouts, Sectional Tracks and Grouped Object) are added by the \f{Fixed-track} command, and the \f{Selection} dialog is displayed which contains a list of available turnouts, sectional tracks and grouped objects for the current scale (\K{cmdLayout}) and a diagram of the selected turnout. You can use the Parameter File Dialog (\K{cmdPrmfile}) to control what turnouts are available. \G{png.d/turnsel.png} -Select a turnout from the scrolling list by \c{Left-Click}ing on it. Move to the Layout and \c{Left-Click} where the turnout should be placed. The Turnout will snap to nearby flextracks or open endpoints. By \c{Left-Drag}ing you can move the turnout around. Additional \c{Left-Click}s change the way the turnout is placed. +Select a turnout from the scrolling list by \c{Left-Click}ing on it. Move to the Layout and \c{Left-Click} where the turnout should be placed. The Turnout will snap to nearby flex-tracks or open endpoints. By \c{Left-Drag}ing you can move the turnout around. Additional \c{Left-Click}s change the way the turnout is placed. The \f{New} button invokes the Turnout Designer (\K{cmdTurnoutNew}) dialog. This button displays a pop-up-menu list of various types of turnouts and sectional track. The \f{Turnout Selection} window will disappear while dragging on the layout if the \f{Hide} Check Box on the dialog is set. This is useful if you have a small screen. -See the Hot Bar (\K{cmdHotBar}) command for details on placing Turnouts on the layout. +See the Hot Bar (\K{cmdHotBar}) command for details on placing Fixed-tracks on the layout. \rule -\S{cmdTurntable} Turntables +\S{cmdTurntable} \i{Turntables} \G{png.d/bturntbl.png} @@ -443,7 +490,7 @@ The \f{Turntable Angle} control on the Preferences (\K{cmdPref}) dialog controls \rule -\S{cmdBlock} Block +\S{cmdBlock} \i{Block} \G{png.d/bblock.png} @@ -466,7 +513,7 @@ information, etc. \rule -\S{cmdSwitchmotor} Switchmotor +\S{cmdSwitchmotor} \i{Switchmotor} \G{png.d/bswitchmotor.png} @@ -490,16 +537,16 @@ could be code snippets or I/O device address information, etc. \rule -\S{cmdSignal} Signal +\S{cmdSignal} \i{Signal} \G{png.d/bsignal.png} -A signal is created by selecting \f{Create Signal} from either the Add menu \K{cmdAdd} or -from the hotbar. Use the mouse to select a location (left button) and then -draging (left button down) the signal to set its orientation. Once the left -button is released, a Create/Edit Signal dialog box is displayed, and you can -fill in the signal's properties: name, fine tune the location and orientation, -number of heads, and the aspects. +A signal is created by selecting \f{Create Signal} from either the Add menu +\K{cmdAdd} or from the hotbar. Use the mouse to select a location (left button) +and then dragging (left button down) the signal to set its orientation. Once +the left button is released, a Create/Edit Signal dialog box is displayed, and +you can fill in the signal's properties: name, fine tune the location and +orientation, number of heads, and the aspects. \G{png.d/signal.png} @@ -514,9 +561,9 @@ causes the aspect to be displayed. \rule -\S{cmdControl} Control +\S{cmdControl} \i{Control} -\G{png.d/bControl.png} +\G{png.d/bcontrol.png} A control is created by selecting \f{Create Control} from either the Add menu \K{cmdAdd} or from the hotbar. Use the mouse to select a location (left button) and then @@ -534,9 +581,9 @@ software to actually effect the state on the control (on or off). \rule -\S{cmdSensor} Sensor +\S{cmdSensor} \i{Sensor} -\G{png.d/bSensor.png} +\G{png.d/bsensor.png} A sensor is created by selecting \f{Create Sensor} from either the Add menu \K{cmdAdd} or from the hotbar. Use the mouse to select a location (left button) and then diff --git a/app/doc/appendix.but b/app/doc/appendix.but index 7c45c4a..ef4d583 100644 --- a/app/doc/appendix.but +++ b/app/doc/appendix.but @@ -107,8 +107,6 @@ Menu and sub-menu items are indicated by \e{File>Open}, which means select the \ \f{Edit Box} - an area where you can enter a String, Integer or Floating Point value. -\f{FlexTrack} - an automatic object on the ToolBar that creates a Cornu Track element - \f{Highlighted} - an area on the Canvas which is in inverse-video. \f{Left-Click} - same as \e{Click}, used in contexts where \e{Right-Click} is also used. @@ -166,7 +164,21 @@ curves were variously called easements, Talbot or Euler spirals. \f{Error Message} - an error message displayed in the Status Bar (\K{mainW}) accompanied by a beep. -\f{Flex-track} - Prefabricated flexible sections of track used on a layout. It usually comes in straight, three-foot-long sections which can be bent or shaped as needed. This term is also used for hand-laid track. +\#{TODO} + +\I{Fixed-track}\f{Fixed-track} - +These include Turnouts, Sectional tracks and Grouped objects. +They are defined in Parameter Files (\K{cmdPrmfile}), or created using the \f{Turnout Designer} (\K{cmdTurnoutNew}) or the \f{Group} (\K{cmdGroup}) command. +They are selected for placement on the layout using the \f{Hot Bar} (\K{cmdHotBar}) or the \f{Fixed-Track} (\K{cmdNewFixedTrack}) dialog. +They can not be directly altered, but can be decomposed with the \f{Ungroup} (\K{cmdUngroup}) command and some cases trimed (\K{splitDivide}). + +\I{Flex-track}\f{Flex-track} - +Flexible sections of track used on a layout. +It usually comes in straight, three-foot-long sections which can be bent or shaped as needed. +These include Straight, Curved, Easements, Cornu and Bezier tracks. +This term is also used for hand-laid track. +They are created by invoking the corresponding command and dragging on the layout. +\f{Easements} (\K{cmdEasement}) are created automatically when joining tracks. \f{Frog} - the place on a turnout track where one rail crosses the other. @@ -182,11 +194,10 @@ curves were variously called easements, Talbot or Euler spirals. \f{Points} - the part of the Turnout that moves to select a path. -\f{Reverse Curve} - a piece of track which curves in one direction then changes direction without any appreciable length of straight track between the two curves. - -\f{S-Curve} - a curve which bends in one direction and then the other, forming an S-like shape. +\f{S-Curve} - (aka \f{Reverse Curve}) a curve which bends in one direction and then the other, forming an S-like shape, without any appreciable length of straight track between the two curves \f{Sectional Track} - prefabricated track which cannot be bent, split or changed. +A type of \f{Fixed-Track}. \f{Selected Endpoint} - when selecting track for various reasons the selected endpoint is the one closest to the selection point. @@ -196,6 +207,8 @@ curves were variously called easements, Talbot or Euler spirals. \f{Turnout} - A piece of track that allows a train to go from one track to another. Called a switch on a real railroad. Referred to by number. For example, a no. 6 turnout spreads one unit for each six units of travel measured from the frog (the point at which two rails join to form a V). +Turnouts are a type of 'Fixed-track' which includes Sectional Tracks and Grouped Objects. + \b In \e{XTrackCAD}, \e{Turnouts} also include sectional Tracks, crossings and forms of prefabricated (non-flex) track. \f{Turnout Frog} - the place on the turnout track where one rail crosses the other. @@ -247,7 +260,7 @@ or virtual track circuit in a Tower-LCC or similar device. \rule -\A{} Messages and Explanations +\A{messages} Messages and Explanations \H{messageType} \i{Message Types} @@ -265,7 +278,7 @@ or virtual track circuit in a Tower-LCC or similar device. \u000 -\dd \e{Notices} and \e{Error messages} that might be encounter are listed here with a explanation. The \f{Recent Messages} menu item on the \f{Help} (\K{helpM}) menu contains a list of the most recent messages. Selecting one of the entries presents information on the particular message. +\dd \e{Notices} and \e{Error messages} that might be encountered are listed here with a explanation. The \f{Recent Messages} menu item on the \f{Help} (\K{helpM}) menu contains a list of the most recent messages. Selecting one of the entries presents information on the particular message. \u000 diff --git a/app/doc/changem.but b/app/doc/changem.but index 97238fb..bf8485a 100644 --- a/app/doc/changem.but +++ b/app/doc/changem.but @@ -12,85 +12,90 @@ The \f{Change Menu} has all functions related to modifying objects that exist on the layout drawing. -\dd \f{Change Scale} - change model scale and / or gauge of layout design. (\K{cmdRescale}) +\dd \i{Properties} - sets \e{XTrackCAD} into \e{Describe} mode. Whenever an object is clicked on while in this mode, the \f{Properties} dialog is opened. This dialog allows direct manipulation of settings such as the objects length, position or orientation. (\K{cmdDescribe}). \u000 -\dd \f{Clear Elevations} - remove elevation parameters from selected track(s). +\dd \i{Select} - sets \e{XTrackCAD} into \e{Select} mode. Whenever an object is clicked on while in this mode, this selection state of this object is reversed. If an object was unselected it becomes selected, and vice versa. To unselect all objects press the ESC key, use \f{Deselect All} from the \f{Edit} (\K{editM}) menu or \f{Deselect All} from the \f{Pop-up} menu (\K{mouseBcmd}). (\K{cmdSelect}). -\u000 +\rule -\dd \f{Connect Two Tracks} - creates a connection between track pieces with an option to slightly move the select piece(s) and the pieces they connect to. (\K{cmdConnect}). +\dd \i{Move} - move selected object(s). (\K{cmdMove}). \u000 -\dd \f{Convert Tracks} - chnages fixed tracks (Straight, Curve, Joint, Bezier) into a Smooth Cornu or vice versa. (\K{cmdConvert}). +\dd \i{Rotate} - rotate selected object(s). (\K{cmdRotate}). \u000 -\dd \f{Elevation} - define an elevation at specified track location (\K{cmdElevation}). +\dd \i{Flip} - turn selected object(s) over or around. (\K{cmdFlip}). \u000 -\dd \f{Flip} - turn selected object(s) over or around. (\K{cmdFlip}). +\dd \i{Loosen Tracks} \I{Track, Loosen} - this command reverses the effect of Connect Two Tracks as applied to sectional track. \u000 -\dd \f{Join} - connect two separate pieces of track. This command can be used to move one of the pieces of track to the endpoint of the other or to create a connection by laying a stretch of flex-track. (\K{cmdJoin}). +\dd \i{Modify} - modify an existing track, or lines. (\K{cmdModify}). \u000 -\dd \f{Modify} - modify an existing track, or lines. (\K{cmdModify}). +\dd \G{png.d/mjoin.png} + +\dd \f{Join} \I{Join Lines} \I{Join Track} \I{Track, Join} - connect two separate pieces of track or two lines. This command can be used to move one of the pieces of track to the endpoint of the other or to create a connection by laying a stretch of flex-track. (\K{cmdJoin}). \u000 -\dd \f{Move} - move selected object(s). (\K{cmdMove}). +\dd \i{Connect Two Tracks} \I{Track, Connect} - creates a connection between track pieces with an option to slightly move the select piece(s) and the pieces they connect to. (\K{cmdConnect}). \u000 -\dd \f{Move Description} - move the endpoint description of a track piece to another location. (\K{cmdMoveLabel}). +\dd \G{png.d/msplit.png} -\u000 +\dd \i{Split} - the \f{Split} commands are used to divide up tracks (\K{cmdSplitTrack}) or split draw objects (\K{cmdSplitDraw}) or use a second Object to Trim (\K{cmdTrimDraw}). +The (\K{cmdSplitTrack}) command can be used in one of two ways; -\dd \f{Pan/Zoom} - move or resize the viewport using the mouse. +\lcont{ \u000 -\dd \f{Profile} - display the elevation profile of a definable stretch of track (\K{cmdProfile}). +\b split a section of flex-track into two connected pieces at the point where a \e{Left-Click} is invoked or; -\u000 +\b disconnect turnouts or sectional track pieces at their point of connection. -\dd \f{Properties} - sets \e{XTrackCAD} into \e{Describe} mode. Whenever an object is clicked on while in this mode, the \f{Properties} dialog is opened. This dialog allows direct manipulation of settings such as the objects length, position or orientation. (\K{cmdDescribe}). +} -\u000 +\dd \i{Move Description} - move the endpoint description of a track piece to another location. (\K{cmdMoveLabel}). -\dd \f{Raise/Lower Elevations} - raise or lower elevation of selected tracks. (\K{cmdRaiseElev}). +\rule + +\dd \i{Raise/Lower Elevations} - raise or lower elevation of selected tracks. (\K{cmdRaiseElev}). \u000 -\dd \f{Rotate} - rotate selected object(s). (\K{cmdRotate}). +\dd \i{Elevation} - define an elevation at specified track location (\K{cmdElevation}). \u000 -\dd \f{Recompute Elevations} - performs a global re-computation of dynamic elevations. It should not be necessary to issue this command as elevations are recomputed as required. +\dd \i{Profile} - display the elevation profile of a definable stretch of track (\K{cmdProfile}). \u000 -\dd \f{Select} - sets \e{XTrackCAD} into \e{Select} mode. Whenever an object is clicked on while in this mode, this selection state of this object is reversed. If an object was unselected it becomes selected, and vice versa. To unselect all objects press the ESC key, use \f{Deselect All} from the \f{Edit} (\K{editM}) menu or \f{Deselect All} from the \f{Pop-up} menu (\K{mouseBcmd}). (\K{cmdSelect}). +\dd \i{Clear Elevations} - remove elevation parameters from selected track(s). \u000 -\dd \f{Split Track} - the \f{Split Track} (\K{cmdSplitTrack}) command can be used in one of two ways; +\dd \i{Recompute Elevations} - performs a global re-computation of dynamic elevations. It should not be necessary to issue this command as elevations are recomputed as required. -\lcont{ +\rule -\u000 +\dd \i{Change Scale} - change model scale and/or gauge of layout design. (\K{cmdRescale}) -\b split a section of flex-track into two connected pieces at the point where a \e{Left-Click} is invoked or; +\rule -\b disconnect turnouts or sectional track pieces at their point of connection. +\dd \G{png.d/mconvert.png} -} +\dd \i{Convert} - changes flex-tracks (Straight, Curve, Joint, Bezier) into a Smooth Cornu or vice versa. (\K{cmdConvert}). \rule @@ -109,11 +114,13 @@ The \f{Change Menu} has all functions related to modifying objects that exist on \b by ratio (by 181.5%). +If the selected objects have multiple Scales then the 1st From box will display "Multi-Scale". +If the selected objects are all of one Scale and but have different Gauges then the 2nd From box will display "Multi-Gauge". + If resizing by modeling scale then track dimensions, e.g., lengths and radii, will be changed as well. An option is available to disable the resizing of the selected objects. \rule - \S{clrElev} Clear Elevations The \f{Clear Elevations} command is used to remove elevation points from selected track on the layout. @@ -122,12 +129,11 @@ Using the \f{Select} command, select the track that is to have its elevation set \rule - \S{cmdConnect} Connect Tracks \G{png.d/bconnect.png} -This command is frequently used with \e{Sectional Track}. But it can be useful to reattach ordinary track which has become disconected or split. +This command is frequently used with \i\e{Sectional Track}. But it can be useful to reattach ordinary track which has become disconected or split. When in this connect, ends of tracks that can be selected are highlighted with a blue arrow. With \e{Shift} added, ends that can be tighten are highlighted with a blue "X". @@ -159,27 +165,27 @@ You can undo the effect of the \f{Connect} command by splitting (\K{splitDisconn \dd (\K{cmdConvertFrom}). Convert Cornu to Fixed. -A drop down menu, which allows selection of the Convert Mode, is invoked from the down arrow button (\G{png.d/bmenu.png}) located on the right side the Convert Tracks button. +A drop down menu, which allows selection of the Convert Mode, is invoked from the down arrow button (\G{png.d/bmenu.png}) located on the right side the Convert Tracks button. Dependent upon previous selection, the Convert Track button will look like \G{png.d/convertto.png} or \G{png.d/convertfrom.png}. \rule -\S2{cmdConvertTo} Convert Fixed Track(s) to Cornu(s) +\S2{cmdConvertTo} Convert flex-track(s) to Cornu(s) \G{png.d/convertto.png} -This command will take a pre-selected set of fixed track elements (Straights, Curves, Joint or Bezier) and convert them into a set of Cornu Tracks. +This command will take a pre-selected set of flex-track elements (Straights, Curves, Joint or Bezier) and convert them into a set of Cornu Tracks. If there are no selected Tracks, the user can click on a single track. -The Cornu(s) will smoothly pass through all the end points of the selected tracks and smoothly join to the end-points (if any). -This may change the internal shape of the resulting track(s) due to smoothing. +The Cornu(s) will smoothly pass through all the end points of the selected tracks and smoothly join to the end-points (if any). +This may change the internal shape of the resulting track(s) due to smoothing. A subsequent \k{cmdModify} can be used to fine tune the Cornu(s) by moving, adding and deleting "pins" in the combined shape. This command is intended to help conversion of track designs that were made before Cornu Track existed to Cornu. \rule -\S2{cmdConvertFrom} Convert Cornu(s) and Bezier(s) to Fixed Track(s) +\S2{cmdConvertFrom} Convert Cornu(s) and Bezier(s) to flex-track(s) \G{png.d/convertfrom.png} @@ -193,17 +199,19 @@ The resulting track(s) will mimic the shape of the Cornu/Bezier(s) exactly. This \G{png.d/belev.png} -The \f{Elevation} command changes the elevation of track endpoints. After opening this dialog, The Message Bar will show the computed elevation at the cursor. There will be an open blue circle if an endpoint will be selected with \f{Left-Click}. You click on the respective endpoint to set its elevation properties. +The \f{Elevation} command changes the elevation of track endpoints. After opening this dialog, The Message Bar will show the computed elevation at the cursor. There will be an open blue circle if an endpoint will be selected with \f{Left-Click}. You click on the respective endpoint to set its elevation properties. + +The endpoint which you are working on is indicated with a big red dot. Note that when an endpoint is selected, the Elevation Window will have focus. To select a different endpoint without closing this window, two clicks (or a double click) will be needed. The first click restores focus to the main window, the second selects the point. -The endpoint which you are working on is indicated with a big red dot. +If you add \f{Shift} as you move the cursor before clicking you will see a blue bar when it is over a track if a \f{Shift+Left-Click} will split the Track at that point (which will give you the opportunity to specify an elevation). -Moving around the layout will show you the elevation at the point indicated by a blue dot. +Adding \f{Ctrl} allows you to \f{Ctrl+Left-Click} to Select and \f{Left-Drag} to move existing Elevation Labels if the option is set for them to be displayed and the Zoom level is adequate, Only "Defined" and "Station" endpoint labels can be moved. -If you hover over a point where two unconnected tracks pass over one another, a blue square will be drawn and the Message Bar will show the two elevations and the Clearance between them. +If you add \f{Alt}, while moving around the layout close to tracks will show you the elevation at the point indicated by a blue closed dot. -If you add \f{Shift} as you move the cursor before clicking you will see a blue bar when it is over a track if a \f{Shift-Left-Click} will split the Track at that point (which will give you the opportunity to specify an elevation). +With \f{Alt} held, if you hover over a point close to where two unconnected tracks pass over one another, a blue square will be drawn and the Message Bar will show the two elevations and the Clearance between them. -Adding \f{Ctrl} allows you to \f{Ctrl+Left-Click} to Select and \f{Left-Drag} to move Elevation Labels if both the option is set for them to be displayed and the Zoom level is correct,, Only Defined and Station endpoint labels can be moved. +Clicking with \f{Shift} at this point will split the track, allowing the elevation to be adjusted to provide adequate clearance. \G{png.d/celev.png} @@ -211,17 +219,17 @@ An endpoint can have one of several elevation types: \u000 -\b \f{None} - no elevation defined. +\b \f{None} - no elevation control defined. This is the default state and the elevation will be computed. It will be shown if the Display Option \K{cmdDisplay} \f{EndPt Elevations} setting is on. -\b \f{Defined} - a defined elevation at a specified height. +\b \f{Defined} - the defined elevation is set to a specified height. The elevation will be shown. -\b \f{Hidden} - a defined elevation but not displayed on the layout. +\b \f{Hidden} - a defined elevation like \f{Defined} but not displayed on the layout. -\b \f{Computed} - height is based on height of closest neighbors. +\b \f{Computed} - height is calculated and displayed even if the Display Option \K{cmdDisplay} \e{EndPt Elevations} is on. -\b \f{Grade} - grade is based on height of closest neighbors. +\b \f{Grade} - grade is based on height of closest neighbors and displayed. -\b \f{Ignored} - endpoint is not considered in computations. +\b \f{Ignored} - endpoint is not considered in computations. This breaks the flow of the elevation influence from one side to the other, resulting in an elevation that is not dependent on the connected track but on the other connected tracks. A common use would be to ensure a mainline dictates the elevation of the start of a branch. \b \f{Station} - assigns a name to the endpoint. @@ -231,9 +239,11 @@ When an endpoint is selected on the layout by \e{Left-Click}, it is highlighted Additionally, \f{Defined Elevation} endpoints are indicated on the layout by gold colored dots. \f{Ignored Elevation} endpoints are indicated by blue colored dots. -The grade at the specified endpoint is displayed next to the \f{Grade} radio button. For \f{Defined Elevation} endpoints, the grade on each side of the endpoint is displayed. +The grade at the specified endpoint is displayed next to the \f{Grade} radio button. For \e{Defined Elevation} endpoints, the grade on each side of the endpoint is displayed. -\f{Defined Elevation} endpoints are used to specify fixed heights of track endpoints. Typically, this would be where a grade changes or where clearances must be maintained. \f{Computed} Elevations and \f{Grade} markers can place between \f{Defined Elevation} endpoints. These values are not entered directly but are computed dynamically based on \f{Defined Elevations} of connected tracks. This allows labeling of elevations at intermediate endpoints without having the enter specific values. \f{Computed} markers can also placed between a \f{Defined Elevation} point and the end of a track. +\f{Defined Elevation} endpoints are used to specify fixed heights of track endpoints. Typically, this would be where a grade changes or where clearances must be maintained. \f{Computed} Elevations and \f{Grade} markers can place between \f{Defined Elevation} endpoints. +These values are not entered directly but are computed dynamically based on \f{Defined Elevations} of connected tracks. +This allows labeling of elevations at intermediate endpoints without having the enter specific values. \f{Computed} markers can also placed between a \f{Defined Elevation} point and the end of a track. \f{Stations} are used to provide information for the Profile (\K{cmdProfile}) command. @@ -246,7 +256,7 @@ All \f{Elevation} labels (including \f{Grade} and \f{Station}) are drawn on the Elevations of Tracks are computed in following steps. The colors listed in each step are used as the background color of the Track Elevation Markers (if they are enabled (\K{cmdDisplay})). -\b The Shortest Paths between all \e{Defined Elevations} are computed. A Path stops at \e{Ignored} or \e{Defined} endpoints. The Elevation of any Turnouts on these Paths with more than two connections are computed as the average Elevation inversely weighted by distance along the tracks to the \e{Defined Elevation} points (\e{Blue}). +\b The Shortest Paths between all \e{Defined Elevations} are computed. A Path stops at \f{Ignored} or \e{Defined} endpoints. The Elevation of any Turnouts on these Paths with more than two connections are computed as the average Elevation inversely weighted by distance along the tracks to the \e{Defined Elevation} points (\e{Blue}). \u000 @@ -260,7 +270,8 @@ Elevations of Tracks are computed in following steps. The colors listed in each \b Any remaining tracks are not connected to a \e{Defined Elevation} and do not have an Elevation. -The elevation computation is performed incrementally every time the layout is changed to keep all elevations in sync. The performance of the computation is affected by the placement of the \e{Defined Elevation} endpoints and the number of Paths between them. Place the \e{Defined Elevations} at points where tracks begin to branch (such as the throat of a yard or at the ends of a siding). Also, use \e{Defined Elevations} to break the layout into areas so recomputation has fewer tracks and Paths to deal with. +The elevation computation is performed incrementally every time the layout is changed to keep all elevations in sync. The performance of the computation is affected by the placement of the \e{Defined Elevation} endpoints and the number of Paths between them. +Place the \e{Defined Elevations} at points where tracks begin to branch (such as the throat of a yard or at the ends of a siding). Also, use \e{Defined Elevations} or \e{Ignore Elevations} to break the layout into areas so recomputation has fewer tracks and Paths to deal with. \rule @@ -306,9 +317,9 @@ Certain turnouts, such as a Wye's, Three-Way or Crossings are symmetrical and th \S{cmdJoin} Join Tracks and Lines -The \f{Join} command has two variatons, +The \f{Join} command has two variatons, -\dd (\K{cmdJoinTrack}). Join Tracks by connecting them. +\dd (\K{cmdJoinTrack}). Join Tracks by connecting them. \u000 @@ -320,7 +331,7 @@ The \f{Join} command has two variatons, \G{png.d/bjoinline.png} -The \f{Join Line} command produces a PolyLine from two Draw objects (Straight Line, Curved Line, Bezier Line or PolyLine). You select the two ends to join and the new Polyline will replace the two Draw objects, filling in any gap with a straight line segment. +The \f{Join Line} command produces a PolyLine from two Draw objects (Straight Line, Curved Line, Bezier Line or PolyLine). You select the two ends to join and the new Polyline will replace the two Draw objects, filling in any gap with a straight line segment. If the two ends are of the same PolyLine, an unfilled Polygon will be created. \rule @@ -339,8 +350,8 @@ For detail about; \u000 -\dd Using Normal Easments where tracks are either joined with a straight or a 'simple curve' \k{joinNormalEasment}, -e.g. one which uses a curve in a single direction as opposed to using reverse curves (\K{generalTerms}) +\dd Using Normal Easements where tracks are either joined with a straight or a 'simple curve' \k{joinNormalEasment}, +e.g. one which uses a curve in a single direction as opposed to using a S-Curve (\K{generalTerms}) \u000 @@ -354,6 +365,8 @@ e.g. one which uses a curve in a single direction as opposed to using reverse cu \S2{joinNormalEasment} Join with Normal Easement +This type of join does not work for Bezier or Cornu tracks, use Cornu Easements (\K{joinCornu}) for these tracks instead. + \u000 \dd \G{png.d/joincrv1.png} @@ -384,15 +397,15 @@ e.g. one which uses a curve in a single direction as opposed to using reverse cu } -After the first track is selected, an entry field for prefered radius will be shown. A non-zero value will enable the snap anchor for the join radius. +After the first track is selected, an entry field for prefered radius will be shown. A non-zero value will enable the snap anchor for the join radius. -\n Move the mouse pointer over the endpoint of the other track then \e{Left-Click} and hold the mouse button down. A track connecting the two endpoints will appear. +\n Move the mouse pointer over the endpoint of the other track then \e{Left-Click} and hold the mouse button down. A track connecting the two endpoints will appear. \lcont{ If the track appears in black (and you are happy with the curve as its drawn), release the mouse button. -If the radius snap-anchor is active, and the position of the cursor is close to a position where the Join is exactly the desired radius, a blue circle will be shown. +If the radius snap-anchor is active, and the position of the cursor is close to a position where the Join is exactly the desired radius, a blue circle will be shown. Releasing the button while it shows will snap the Join to the desired radius. If Easements are enabled as well, this fixed radius Join track will be joined to by easements. @@ -445,11 +458,11 @@ For detail about; \i{Creating a Cornu} \i{Modifying a Cornu} \i{Cornu Easements} -A Cornu is a form of curve that uses a mathematical approach to creating a curve between two sets of end conditions. +A Cornu is a form of curve that uses a mathematical approach to creating a curve between two sets of end conditions. The curve is designed to change curvature linearly along its length - which is the characteristic of a railway easement because it minimizes sudden changes in acceleration towards the center of curvature. -The conditions used at each end are the radius, angle and position. +The conditions used at each end are the radius, angle and position. Cornus can have added constraints in the form of track "pins" that force the curve to smoothly pass through that point while still respecting the end conditions. @@ -465,7 +478,7 @@ It is not always the case that the Cornu will be the most efficient way to get f \S2{cornuTrackPins} Cornu Track Pins -XTrackCAD Cornu can have "track pins" added that constrain the track to pass through those points in addition to meeting the end-conditions. +XTrackCAD Cornu can have "track pins" added that constrain the track to pass through those points in addition to meeting the end-conditions. This allows the track to be skewed or slewed around obstacles, or to suit some other constraint. The pins can be added when Cornus are created \K{cmdCornu} or during \K{cmdModify} after clicking on the track. They can be selected and then \c{Left-Drag} dragged to alter the curve shape or deleted with \c{Delete}. @@ -476,7 +489,7 @@ When a Cornu Track with pins is saved, it is split into two Cornu joined at the \n First, ensure that the Easement type option is set to Cornu - see \k{cmdEasement} -\n Start the Join Track process by clicking on the Join Track button (\G{png.d/bjoin.png}). +\n Start the Join Track process by clicking on the Join Track button (\G{png.d/bjoin.png}). As you move over tracks a blue roundel will indicate the end that will be chosen with \e{Left-Click}. @@ -486,7 +499,7 @@ As you move over tracks a blue roundel will indicate the end that will be chosen \u000 -\dd \c{Left-Drag} the endpoint to where you want it and release the button. +\dd \c{Left-Drag} the endpoint to where you want it and release the button. The point will only move along the piece of track with the open endpoint (if this track type can be split) as far as the opposite end, or as an extension of that track at the selected end with the same curvature (if this track can be extended). Note that you will be able to fine-tune the end positions later. \lcont{ @@ -503,8 +516,8 @@ The point will only move along the piece of track with the open endpoint (if thi \u000 -\dd \c{Left-Drag} the endpoint to where you want it and release the button. -The second endpoint can only be moved along the second track as far as the other end (if it can be split) or as an extension beyond the end of this track (if it can be extended). +\dd \c{Left-Drag} the endpoint to where you want it and release the button. +The second endpoint can only be moved along the second track as far as the other end (if it can be split) or as an extension beyond the end of this track (if it can be extended). The initial curve will be drawn - it will be red if the minimum radius is smaller than the minimum radius option. \lcont{ @@ -517,11 +530,11 @@ The initial curve will be drawn - it will be red if the minimum radius is smalle } -\dd You are now in "Select Points" mode. +\dd You are now in "Select Points" mode. \u000 -\dd You can select one end point at a time with \c{Left-Click} and move it with \c{Left-Drag}. If you drag the end point off the original track it will extend. +\dd You can select one end point at a time with \c{Left-Click} and move it with \c{Left-Drag}. If you drag the end point off the original track it will extend. \u000 @@ -677,7 +690,9 @@ Either the left mouse button (for changing length or creating a tangent track) o \S2{objectModify} Modifying Objects -\n The endpoints of a \e{Line}, \e{Dimension Line}, \e{Table Edge} or \e{Bench-work} can be dragged to new positions. +\n The endpoints of a \e{Line}, \e{Dimension Line}, \e{Table Edge} or \e{Benchwork} can be dragged to new positions. + +\n The ends of a \e{Ruler} or the ends and origin of a \e{Protractor} can be dragged to new positions \n A \e{Box} or a \e{FilledBox} can be modified by selecting a corner and dragging in two dimensions, or a side and dragging it orthogonally. This modifications preserve a 4-sided rectangle. @@ -730,12 +745,15 @@ For more detail about; \lcont{\u000} \n With the mouse pointer hovering over the endpoint of the object to be modified, \e{Left+Drag} (\K{windowTerms}) to change the length of the track segment, table edge, bench-work, dimension line or line. +If \f{MagneticSnap} is enabled, the end will snap to any close draw object. \c{Alt} inverts the MagneticSnap setting. If there is no nearby object and \f{SnapGrid} is enabled, the end will snap to a grid point unless \f{Alt} is added. \lcont{\u000} \e{Left+Drag}ging the endpoint of a turnout (or other sectional track) causes a straight length of flex-track to be created from the selected endpoint to the cursor. -\e{Left+Drag}ging the endpoint of a \f{Table Edge} (\K{cmdDraw}) allows the endpoint to be moved to a new position. If the endpoint is moved close to another \f{Table Edge} then the endpoint will be moved to it. +\e{Left+Drag}ging the endpoint of a \f{Table Edge} (\K{cmdDraw}) allows the endpoint to be moved to a new position. If \c{Ctrl} is added and the endpoint is moved close to another \f{Table Edge} then the endpoint will be moved to it if not, the line will be a multiple of 90 degrees. + + The length of a curved track can be changed to form an almost complete circle by selecting one endpoint of the curved track then dragging the cursor to the other endpoint. Going past the other endpoint creates a very small curve. Curves greater than 360\u00B0 cannot be created. @@ -893,7 +911,7 @@ When a Polygon or a PolyLine is modified, open blue circle anchors show the posi \u000 -\b \f{Delete} will remove a selected node. +\b \f{Delete} or \f{Backspace} will remove a selected node. \u000 @@ -1042,7 +1060,7 @@ A move can be achieved using one of the following methods; \u000 -During a Move of tracks, and \f{MagneticSnap} is enabled, if one of the end-points of the selected objects is close to an open end of a unselected point, two anchors (an open an closed blue ball) will appear. +During a Move of tracks, and \f{MagneticSnap} (\K{cmdMagneticSnap}) is enabled, if one of the end-points of the selected objects is close to an open end of a unselected point, two anchors (an open an closed blue ball) will appear. This indicates that the two points will auto-join and that all the moved tracks will align to the unselected point if the Move is stopped. This behaviour can be suppressed with \e{Alt}. If \f{MagneticSnap} is disabled, the alignment will only occur if \e{Alt} is pressed. @@ -1068,7 +1086,7 @@ Move An Object Using Fixed or Specified amounts of X and Y Translation. A pop-up menu with additional menu items allows you to \f{Move} the selected object(s) through through any amount you specify. -\G{png.d/mmovevariable.png} +\G{png.d/mentermove.png} The \f{Move} command is executed as follows; @@ -1078,17 +1096,16 @@ The \f{Move} command is executed as follows; \n \e{Shift+Right-Click} to raise the Move/Rotate menu. -\lcont{\u000 +\lcont{\u000} Any amount of precise transalation may be entered by \e{Left-Click}ing the \f{Enter Move...} menu item then entering a desired amount of translation in X and Y in the dialog window that appears. \u000 -\G{png.d/dmovetranslate.png} +\G{png.d/dentermove.png} \u000 -} \rule @@ -1097,17 +1114,70 @@ Any amount of precise transalation may be entered by \e{Left-Click}ing the \f{En \G{png.d/bmovedes.png} -This command is used to move Elevation, Grade, Station (\K{cmdElevation}), Curved Track (\K{cmdCurve}), Bezier, Cornu, Helix (\K{cmdHelix}) and Structure or Turnout (\K{cmdHotBar}) Labels. +This command is used to move Elevation, Grade, or Station (\K{cmdElevation}), and to enable/disable and move +Straight Track (\K{cmdStraight}), Curved Track (\K{cmdCurve}), Bezier (\K{cmdBezier}, Cornu (\K{cmdCornu}), Joint (\K{cmdJoin}), Helix (\K{cmdHelix}) and Structure or Turnout (\K{cmdHotBar}) Labels. The \f{Move Description} command can be invoked using the \f{Change>Move Description} menu item or the \f{Move Description} button. -Click the \f{Move Description} button to activate the \f{Move Description} command. As the cursor passes close to an object that can display a label it will be highlighted. A dark blue indicates a label that has "Show Description" set on, a light blue set off. +Click the \f{Move Description} button to activate the \f{Move Description} command. As the cursor passes close to an object that can display a label it will be highlighted. +A dark blue indicates a label that has "Show Description" set on, a teal color means it is set to hide. Use \e{Left+Drag} to move the label to a new position and unhide if hidden. Once moved, the label becomes fixed in a position relative to the object. Subsequent moves of that object will cause the label to move as well. This operation can also be invoked by \e{Ctrl+Left+Drag} when in Select command (\K{cmdSelect}). -The letter "\f{h}", can be used to hide display of individual Curved Track, Bezier Track, Cornu, Helix or Turnout Labels. The letter"\f{s} will show a hidden description. There is a \f{Context Menu} Show/Hide Toggle as well. +Note that labels need to be visible in the Display menu and the layout needs to be zoomed in enough to show labels for them to be moved. + +There are keys that control the display of description when hovering over a description or a track. + +\b The letter "\f{s}" when hovering over a track will show the hidden description - the teal highlight will show which tracks can have descriptions. + +\b The letter "\f{h}", when hovering over the track or description, can be used to hide display of individual Curved Track, Bezier Track, Cornu, Helix, Joint or Turnout Labels. + +\b The letter "\f{d}" will enable and disable a detailed description which is intended for tracklaying - it is a table of points and track angles that lie along the track path. + +Using these detailed values a curve can be constructed even for complex objects such as Bezier or Cornu. + +There is a \f{Context Menu} invoked with \e{Right-Click} or \e{Shift plus Right-Click} to Show/Hide individual descriptions as well as set the description to detailed. + +Labels can be moved by hovering the "hot spots" or over the attached track object. \e{Left-Drag} will reposition it. Elevation labels can be selected by hovering of thier centers or the end point they refer to. +Note that end points with elevation mode "None" are not selectable. + +\b Cornu, Bezier, Straight, Curve and Joint (Easement) Labels can be moved along the line between the end-points and also laterally. + +\lcont{\u000 + +\b Cornu and Bezier Tracks show the "chord" length, its absolute angle, and the length of the track and the minimum radius. +To help lay these variable radius curves out, the detailed description information about track centers and angles selected by \f{'d'} is suggested. + +\b Joint/Easement Tracks show the "chord" length and abslute angle and easement curve constructing values of Radius and Lengths. +For laying out larger easmements, the detailed position and angle description selected by \f{'d'} may be useful. + +\b Straight Tracks show the length and the absolute angle. +For laying out long straights, the detailed track center position and angle descriptions selected by \f{'d'} may be useful. + +\b Curved Tracks show the radius, chord length, deflection at the center from the chord and the angular length. +For laying out curves, the detailed track center position and angle descriptions selected by \f{'d'} may be useful. + +} + +\u000 + +\b Curve Track Labels can be moved so that the label is somewhere on a radial line from the center to a position within the arc. +A Curve label shows the absolute angle of the chord, its length, the Curve Radius and the deflection from the chord at the center of it. +This enables the curve to be laid out even if the center point of the arc is inaccesible. Note that the detailed description may also be helpful in this case. + +\u000 + +\b Compound (Structure and Turnout) Labels can be moved without restriction. They show the Object's Title information. + +\u000 + +\b Elevation points labels can be moved without restriction - they show the Grade, Elevation, or Station Name as appropriate. + +\u000 + +\b The detailed description setting is not preserved in the saved layout. It is designed for use when transferring a complex part of the plan to a real layout. Note - existing defined elevation labels can be moved, but controlling thier visbility is done with the \K{cmdElevation} command. @@ -1199,9 +1269,10 @@ The dialog can be closed with the 'X' button in the window's titlebar. Clicking on the \f{Properties} (Describe Mode) button cancels all active commands, closes any open dialog windows and places focus on the main window. Until an object is selected, the object under the cursor that will be selected with \e{Left-Click} is highlighted in blue. +Objects in Frozen Layers will only be highlighted and selected if \f{Shift} is added. A \e{Left-Click} on an object while in \f{Properties} mode causes a properties dialog window to appear. -The properties dialog contains information pertaining to the selected objects position, size, color and layer as appropriate for each type of object. +The properties dialog contains information pertaining to the selected objects size, position, size, color and layer as appropriate for each type of object. Certain values can be changed to modify the object. Some values, e.g., endpoint positions, can not be changed if, for example, a Track is joined to another Track. The values will take effect when \f{Enter}, \f{Tab} is pressed or the cursor leaves the entry field. @@ -1209,47 +1280,61 @@ The values will take effect when \f{Enter}, \f{Tab} is pressed or the cursor lea The selected object is highlighted by a grey area. -If it is a Line, Curve, Circle or Polygon object, and the rotation origin is non-zero, a large blue cross will show its position. - \G{png.d/dpropertieshighlight.png} -\S2{drawDescribe} Draw Object Fields +\S2{drawDescribe} Draw Object Describe Fields + +\S3{drawDescribeCommon} Common Draw Object Fields + +If the Object is a Line, Curve, Circle or Polygon object, and the rotation origin is non-zero, a large blue cross will show its position. +If it is zero, the command starts with the \f{Lock Origin} field unticked and the \f{Rotate By} field greyed out. Some fields are used by multiple types of objects - these are listed below \dt Line Width \dd The width of the line for a line, curve or unfilled object can be set. 0 means a pixel width at all scales. -Other values are the width of the line in scale units. +Other values are the width of the line in scale units. If the value is negative, it is the absolute value of pixels wide at all scales. \dt Pivot -\dd The Pivot control can be set to the start, or the middle or the end, and it applies to the Length and Angle controls - -\dt Rotation Angle - -\dd Some Draw objects (Polygon, Polyline, Lines, Curves, Circles) can be rotated about their rotation origin in Describe. -After the rotation completes, the rotation angle will be set to zero, as all the points of the object will be adjusted to thier absolute position in the layout. +\dd The Pivot control can be set to fix in place the start, or the middle or the end, and it applies to the Length, Line Angle and Angular Length controls. +When these are changed the new dimensions are applied so as to keep the locked position in place. \dt Rotation Origin \dd By default the rotation origin is the Layout origin \{0,0\}. -By setting a different Rotation Origin, subsequent Rotations will be about that new point. This may be useful when using Draw objects as part of larger collections. +If the origin is not at the Layout origin, it will be displayed with a blue cross. +When the origin is changed with the \f{Lock} off, the object is not moved. +But if the origin is changed with the \f{Lock} on, the object will be moved as well. +Enabling the \f{Lock To Origin} allows subsequent Rotations to be about the origin. +This may be especially useful when using creating larger groups of Draw objects. + +\dt Lock To Origin + +\dd Locking to the rotation origin makes the distance between the First Point and the origin fixed. +If this is set on, altering either the First Point or the Rotation Origin will move the both values. +This value is initially set to locked if the Draw origin is non-zero when the \K{cmdDescribe} command is started +but can be unset to allow repositioning of the Rotate Origin without moving the object in the layout. +If the Rotate Origin is set to \{0,0\}, the Object has an \e{Absolute} origin. -\dt Lock Rotation Origin +\dt Rotate By -\dd For ease of use, the rotation origin can be \e{Relative} to the First Point. If this is done, altering either the First Point or the Rotation Origin will move the both values. -This value is always set to locked if the Draw origin is non-zero when the \K{cmdDescribe} command is started but can be unset to allow repositioning of the Rotate Origin without moving the object. If the Rotate Origin is set to zero, the Object has an \e{Absolute} origin. +\dd Some Draw objects (Polygon, Polyline, Lines, Curves, Circles, Text) can be rotated about their rotation origin in Describe. +In order to rotate them, the \f{Lock To Origin} must be enabled. +After the rotation completes, the rotation angle will be set back to zero and all the points of the object will be adjusted to their absolute position in the layout. +Negative values of rotation are counter-clockwise. +Note that for Text objects, the Rotation also changes the \f{Text Angle}. \dt Layer -\dd The object can be moved between layers +\dd The layer of the object. The object can be moved between layers if the layer is not frozen. Only non-frozen layers are listed as options. \dt Color \dd The color of the line or the fill can be set -\S3{drawDescribeStr} Straight Line Objects +\S3{drawDescribeStr} Straight Line Objects Describe Fields \dt End Pt 1 @@ -1259,13 +1344,13 @@ This value is always set to locked if the Draw origin is non-zero when the \K{cm \dd Straight Lines have a second point, altering this, moves just that end of the line, altering its length as needed. -\dt Angle +\dt Line Angle -\dd Straight Lines have an angle - this is the angle between the two points, altering this moves End Pt2. +\dd Straight Lines have an angle - this is the angle between the two points, altering this moves the ends so as to respect the \f{Pivot} control setting. \dt Length -\dd The Length control can add to the start or end or both of a Line object depending on the setting of the Pivot control. +\dd The Length control can add to the start or end or both of a Line object depending on the setting of the \f{Pivot} control setting. \S3{drawDescribeDim} Dimension Line Objects @@ -1273,7 +1358,7 @@ This value is always set to locked if the Draw origin is non-zero when the \K{cm \dd The size of the arrows and text can be set to Tine, Small, Medium or Large. -\S3{drawDescribeBench} BenchWork Objects +\S3{drawDescribeBench} BenchWork Objects Describe Fields \dt Lumber @@ -1283,7 +1368,7 @@ This value is always set to locked if the Draw origin is non-zero when the \K{cm \dd The timber can be orientated "On Edge" which will draw the smaller dimension or "Flat". -\S3{drawDescribeCurve} Curved and Circle Objects +\S3{drawDescribeCurve} Curved and Circle Objects Describe Fields \dt Center @@ -1291,9 +1376,13 @@ This value is always set to locked if the Draw origin is non-zero when the \K{cm \dt CW Angle and CCW Angle -\dd Curved Lines have an angle relative to the center that the arc starts and and one where it ends +\dd Curved Lines have an angle relative to the center that the arc starts and and one where it ends. + +\dt Angular Length -\S3{drawDescribePoly} Polygon Objects +\dd For Curved Lines this is the length of the arc in degrees. If altered it will move the arc to respect the \f{Pivot} control setting. + +\S3{drawDescribePoly} Polygon Objects Describe Fields \dt Fill @@ -1301,7 +1390,7 @@ This value is always set to locked if the Draw origin is non-zero when the \K{cm \dt Open -\dd Polygons can be opened to become Polylines or Polylines closed to become Polygons using Describe. +\dd Unfilled Polygons can be opened to become Polylines or Polylines closed to become Polygons. Note that PolyLines can't be filled, they have to be closed first. \dt Point Count @@ -1315,12 +1404,149 @@ This value is always set to locked if the Draw origin is non-zero when the \K{cm \dd Straight and Curved Lines, PolyLines, Polygons and Structures can be drawn with dotted, dashed, dash-dotted and dash-dot-dotted lines. -\S3{drawDescribeText} Text Objects +\S3{drawDescribeText} Text Objects Describe Fields \dt Text Angle -\dd For Text objects, the Text Angle determines the angle the text is rendered at. This is independent of the rotation of the starting position which is gained from the Rotation Angle and the Rotation Origin. +\dd For Text objects, the Text Angle determines the absolute angle the text is rendered at. + +This will be set by itself or by rotation of the starting position about the Rotation Origin with \f{Lock to Origin} set. + +\dt Boxed + +\dd For Text objects, whether a line is drawn around the text. + +\S2{DescribeCompound} Structures, Sectional Track and Turnouts Describe Fields + +\dt Pivot + +\dd The Pivot fixes the point about which the Angle of Rotation will occur to be the Start (Bottom Left) Point, the middle of the object, or End (Top Right) of the object. +These relative positions are calculated as though the object was rotated by zero degrees. + +\dt Angle + +\dd The Angle rotates the object about the Pivot point. + +\S2{DescribeTrack} Describe Track Fields + +\S3{trackDescribeCommon} Common Track Object Fields + +\dt End Pt 1 + +\dd For the starting position (or first point) - altering this value causes the whole object to move relative to the layout origin. +This can only be changed if the track is unconnected at that end. The elevation is shown beneath the X,Y as a read-only Z value. + +\dt End Pt 2 + +\dd The end position (or second point), altering this, moves just that end of the line, altering its length as needed. +This can only be changed if the track is unconnected at that end. The elevation is shown beneath the X,Y as a read-only Z value. + +\dt Grade + +\dd The calculated grade between the two end-points + +\dt Layer + +\dd The layer of the object. The object can be moved between layers if the layer is not frozen. Only non-frozen layers are listed as options. + +\dt Length + +\dd The length of the track object. This can be set for a Straight Track if it is not connected, and will respect the value of the \f{Pivot} field. + +\dt Pivot + +\dd The Pivot control can be set to fix in place the start, or the middle or the end, and it applies to the Length, Track Angle and Angular Length controls. +When these are changed the new dimensions are applied so as to keep the locked position in place. + +\S3{trackDescribeStr} Straight Track Describe Fields + + +\dt Track Angle + +\dd The angle of the Track object. This can be set if the track is not connected. It respects the value of the \f{Pivot} field + + +\S3{trackDescribeCurve} Curved Track Describe Fields + +\dt Center + +\dd The center point of the curve. The center can only be modified if both ends are unconnected. + +\dt Radius + +\dd The radius of the curve. The radius can only be modified if one end is not connected. + +\dt Angular Length + +\dd The length of the curve in degrees. Modifications respect the \f{Pivot} value and are only available if at least one end is disconnected. + +\dt CCW Angle + +\dd The Counter-Clockwise Angle (the angle from the center to the first position). Can only be modified if the first end of the curve is not connected. + +\dt CW Angle + +\dd The ClockWise Angle (the angle from the center to the end position). Can only be modified if the second end of the curve is not connected. + + +\S3{trackDescribeCornu} Cornu Track Describe Fields + +\dt End Angle + +\dd Each end has an angle which helps determine the curve shape. It can only be set if the Track is not joined at that end. + +\dt End Radius + +\dd Each end has an radius which helps determine the curve shape. It can only be set if the Track is not joined at that end. + +\dt End Pt + +\dd Each End Point has a position. It can only be set if the Track is not joined at that end. + +\dt Center + +\dd Each End shows the center of the curve of the end segment - this is a read-only field. If the radius is zero, the field will show \{0,0\}. + +\dt Minimum Radius + +\dd This is the approximate smallest radius along the curve based on curve fitting to the Cornu. + +\dt Maximum Rate of Curvature + +\dd The maximum rate that the radius is changing over its length based on curve fitting. +It gives an idea of the "sharpness" of the curve. + +\dt Total Winding Angle +\dd The number of degrees that the curve executes - this number will rise if there are loops in the curve. + +\S3{trackDescribeBezier} Bezier Track Describe Fields + +\dt Ctl Pt + +\dd The positions of the two Bezier control points. These will only be adjustable if the end they control is not attached to another track. + +\dt End Angle + +\dd Each end has an angle which is set by the control arm at that end - this is a read-only field + +\dt End Radius + +\dd Each end has an radius which is driven by the curve shape - this is a read-only field + +\dt End Pt + +\dd Each End Point has a position. It can only be set if the Track is not joined at that end. + +\dt Center + +\dd Each End shows the center of the curve of the end segment - this is a read-only field. If the radius is zero, the field will show \{0,0\}. + +\dt Minimum Radius + +\dd This is the approximate smallest radius along the curve based on curve fitting to the Bezier. + +\rule Most commands return to \f{Properties} mode then they terminate unless the command is sticky (\K{cmdSticky}). @@ -1370,8 +1596,8 @@ Rotation can be achieved using one of the following methods; \dd Aligning the selected object with another object on the layout. See \K{rotateByAlign} for detail. -During Rotation of a track, if \f{MagneticSnap} is enabled, if one of the end-points of the selected objects is close to an open end of a unselected point, two anchors (an open an closed blue ball) will appear. -This indicates that the two points will auto-snap and the moved track will align to the unselected point if the Rotation is stopped. This does not happen if \e{Alt} is used. +During Rotation of a track, if \f{MagneticSnap} (\K{cmdMagneticSnap}) is enabled, if one of the end-points of the selected objects is close to an open end of a unselected point, two anchors (an open an closed blue ball) will appear. +This indicates that the two points will auto-snap and the moved track will align to the unselected point if the Rotation is stopped. This does not happen if \e{Alt} is used. If \f{MagneticSnap} is disabled, the snap will only occur if \e{Alt} is held. Note that this also applies to \K{cmdMove}. @@ -1394,19 +1620,19 @@ Rotate An Object Using the Mouse \lcont{\u000} -\n Click and hold the left mouse button then drag (\e{Left+Drag}) the mouse away from the axis point to create a "handle". This handle will be used to rotate the object. While continuing to hold the left mouse button, drag (\e{Left+Drag}) the handle in the desired direction of rotation. +\n Click and hold the left mouse button then drag (\e{Left+Drag}) the mouse away from the axis point to create a "handle". This handle will be used to rotate the object. While continuing to hold the left mouse button, drag (\e{Left+Drag}) the handle in the desired direction of rotation. \f{Note:} If the \e{Shift+Ctrl} key is pressed in conjunction with \e{Left+Drag}, the object will rotate in increments of 15\u00B0. \lcont{\u000} -\n Release the mouse key once desired rotation is obtained. +\n Release the mouse key once desired rotation is obtained. \u000 -\n If \f{Magnetic Snap} is enabled and the \e{Alt} button is not pressed, or ifthe \e{Alt} button is pressed when it is disabled, a magnetic anchor will be displayed if an end of the rotated tracks is near an open end. +\n If \f{Magnetic Snap} is enabled and the \e{Alt} button is not pressed, or ifthe \e{Alt} button is pressed when it is disabled, a magnetic anchor will be displayed if an end of the rotated tracks is near an open end. If the anchor shows and the rotate is completed, the tracks will Snap to Alignment and Join. -\u000 +\u000 Rotation can also be achieved through use of one of these alternate methods; @@ -1535,7 +1761,7 @@ Clicking on the \f{Select} button cancels all active commands, closes any open d In combination with the mouse, the \f{Select} command can be used as follows; -\dd Unselected Objects that will be added to the selected set with a \e{Left-Click} are highlighted in Blue as the mouse moves over them. Items that will be deselected are highlighted in Gold. +\dd Unselected Objects that will be added to the selected set with a \e{Left-Click} are highlighted in Blue as the mouse moves over them. Items that will be deselected are highlighted in Gold. \u000 @@ -1543,16 +1769,16 @@ In combination with the mouse, the \f{Select} command can be used as follows; \u000 -\dd \e{Left-Click} - if the \f{SelectMode} in \K{cmdCmdopt} is set to Single Item Mode it selects just an object near the cursor. -If it is set to Add Item Mode, it will add the nearby object or remove it if is already selected. -Already selected objects appear in red (unless changed in the \f{Color} (\K{cmdRgbcolor}) dialog) and a blue selection box surrounds all currently selected objects. +\dd \e{Left-Click} - if the \f{SelectMode} in \K{cmdCmdopt} is set to Single Item Mode it selects just an object near the cursor. +If it is set to Add Item Mode, it will add the nearby object or remove it if is already selected. +Already selected objects appear in red (unless changed in the \f{Color} (\K{cmdRgbcolor}) dialog) and a blue selection box surrounds all currently selected objects. If \f{SelectZero} is selected in \K{cmdCmdopt} and an point that is not near to any object is selected, all objects are deselected. \u000 \dd \e{Ctrl+Left-Click} - if \f{SelectMode} in \K{cmdCmdopt} is set to Single Item Mode it adds an object near to the cursor to the selected objects, or removes if it is already selected. -If set to Add Item Mode, it will select only the nearby object and delselect all the others. -Already selected objects appear in red (unless changed in the \f{Color} (\K{cmdRgbcolor}) dialog) and a blue selection box surrounds all currently selected objects. +If set to Add Item Mode, it will select only the nearby object and delselect all the others. +Already selected objects appear in red (unless changed in the \f{Color} (\K{cmdRgbcolor}) dialog) and a blue selection box surrounds all currently selected objects. If \f{SelectZero} is selected in \K{cmdCmdopt} and an point that is not near to any objects is selected, all objects are deselected. \u000 @@ -1569,7 +1795,21 @@ If \f{SelectZero} is selected in \K{cmdCmdopt} and an point that is not near to \u000 -\dd \e{Right-Click} - displays a pop-up menu of commands. +\dd \e{Right-Click} and \e{Shift-Right-Click} - either display a pop-up menu of commands or a set of context commands for the item under the cursor depending on the setting of "Right-Click" in \K{cmdCmdopt}. + +\lcont{ + +\u000 + +\G{png.d/mselectcmd.png} or \G{png.d/mselectcontext.png} + +\u000 + +} + +\u000 + +\dd \e{Double-Click} - invokes \K{cmdModify} on the object after selecting it for eligible objects. Otherwise it acts as \e{Left-Click}. \u000 @@ -1577,27 +1817,38 @@ If \f{SelectZero} is selected in \K{cmdCmdopt} and an point that is not near to \u000 -\dd \e{"@"} - moves the center of the window (i.e., Pans) to be at the cursor position +\b \e{"e"} sets the zoom to a value that allows all the room to be shown and moves the origin of bottom left of the window to be 0,0 -\dd \e{Shift+Ctrl} plus the \e{Arrow Keys} will move the selected items a pixel at a time at the current zoom level. No autosnap will occur to permit fine tuning. +\u000 -\lcont{ +\b \e{"s"} sets the zoom to show the selected set of objects and pans the window to center the highlit area. \u000 -\G{png.d/mselect.png} or \G{png.d/mselected.png} +\dd \e{"c"} - moves the center of the window (i.e., Pans) to be at the cursor position \u000 +\dd Hovering over a selected object (inside the blue highlight area) displays an anchor. The Anchor shows the actions available - + +\lcont{ + +\b If the \e{Shift} key is depressed, a "cross-arrows" anchor shows that a \K{cmdMove} will occur with \e{Left-Click}. + +\b If the \e{Ctrl} key is depresesed, a "rotation-circle" anchor shows that a \K{cmdRotate} will occur with \e{Left-Click}. + +\b With neither depressed a "target" anchor shows that a \e{Double-Click} will invoke \K{cmdModify} within Select for the object hovered over. + } \u000 -\dd Hovering over a selected object (inside the blue highlight area) with either a \e{Shift} or a \e{Ctrl} button depressed displays an anchor that shows that a Left-Drag will either Move or Rotate the selected items. +\dd \e{Shift+Ctrl} plus the \e{Arrow Keys} will move the selected items a pixel at a time at the current zoom level. No autosnap will occur to permit fine tuning. \u000 -\dd \e{Shift+Right-Click} (\K{cmdAcclKeys}) - displays a pop-up menu of options controlling how objects are drawn during moves and rotates (below). If there are selected objects then additional menu items allow you to rotate the selected objects by various angles. +\dd \e{Shift+Right-Click} or \e{Right-Click} (depending on the setting of \f{Right-Click} in \K{cmdCmdopt}) - +Shows context menu items that allow you to perform actions on the selected item(s) including rotating them by various angles and moving them fixed amounts. \u000 @@ -1618,7 +1869,26 @@ Upon release of the button, all the selected tracks will be moved and aligned an \u000 -The following commands operate on the objects you have selected: +\dd \e{Double-Click} - on a eligible object such as a Link Object will Activate it, and on a Modifyable object will go into Modify Mode (\K{cmdModify}) within Select. + +\u000 + +\dd \e{Right-Click} and \e{Shift-Right-Click} - either display a pop-up menu of commands or a set of context commands for the items selected depending on the setting of "Right-Click" in \K{cmdCmdopt}. +The options effects depend on the type of object(s) selected and hovered over. + +\lcont{ +\u000 + +\G{png.d/mselectcmd.png} or \G{png.d/mselectedcontext.png} + +\u000 + +} + +Once Objects are + + +Once objects are selected, the following commands operate on them: \b \f{Move} (\K{cmdMove}) the selected objects. @@ -1638,7 +1908,7 @@ The following commands operate on the objects you have selected: \b \f{Export} (\K{cmdExport}) the selected objects. -\b Creates a structure or turnout definition from \f{Grouped} (\K{cmdGroup}) objects. +\b \f{Group} Creates a structure or turnout definition (\K{cmdGroup}) from the objects. \b \f{Rescale} (\K{cmdRescale}) the selected objects. @@ -1666,12 +1936,15 @@ Notes: \rule +\S{cmdSplit} Split Commands + +There are two split commands, \K{cmdSplitTrack} and \K{cmdSplitDraw}. -\S{cmdSplitTrack} Split Track +\S2{cmdSplitTrack} Split Track \G{png.d/bsplit.png} -The \f{Split} command provides several functions. It can be used to disconnect the joint between two sections of connected track, to divide a section of track into two pieces at a selected point or to place block gaps at an existing joint. +The \f{Split Track} command provides several functions. It can be used to disconnect the joint between two sections of connected track, to divide a section of track into two pieces at a selected point or to place block gaps at an existing joint. Until a split point is selected, the split point under the cursor will have a blue marker and if it is near a connected end a blue "X" will indicate that a split will occur. @@ -1683,7 +1956,7 @@ For detail about; \u000 -\dd Dividing a section of flex track into two connected pieces or trimming a turnout see \K{splitDivide}. +\dd Dividing a section of flex-track into two connected pieces or trimming a turnout see \K{splitDivide}. \u000 @@ -1733,11 +2006,11 @@ For detail about; \rule -\S2{splitDivide} Divide Track +\S3{splitDivide} Divide Track -Dividing a section of flex track into two connected pieces; +Dividing a section of flex-track into two connected pieces; -\n Click the \f{Split} button (\G{png.d/bsplit.png}) to activate the \f{Split} command. +\n Click the \f{Split Track} button (\G{png.d/bsplit.png}) to activate the \f{Split Track} command. \n Place the mouse pointer over the point on the track where the it should be divided. A blue anchor bar across the track under the cursor will indicate the current split point. Then \e{Left-Click}. @@ -1745,7 +2018,7 @@ Dividing a section of flex track into two connected pieces; \lcont{\u000} -\dd When the \f{Split} command completes, a connected joint will appear in the track at the point of selection. To split and disconnect at a point, execute the \f{Split} track command twice. The first command will split the track, the second command will disconnect it. +\dd When the \f{Split Track} command completes, a connected joint will appear in the track at the point of selection. To split and disconnect at a point, execute the \f{Split} track command twice. The first command will split the track, the second command will disconnect it. \u000 @@ -1780,7 +2053,7 @@ For detail about; \rule -\S2{splitBlockGap} Adding \i{Block Gaps} +\S3{splitBlockGap} Adding \i{Block Gaps} The \f{Split} command can be used to add block gaps (\K{generalTerms}) at the point where two track endpoints join. Block gaps are drawn as a thick line and can be placed in either of the rails or both if total isolation is required. @@ -1833,3 +2106,41 @@ For detail about; \dd Dividing a section of track into two connected pieces see \K{splitDivide}. \rule + +\S2{cmdSplitDraw} Split a Draw Object + +The \f{Split Draw} command can be used to split many draw object (Straight Lines, Curved Lines, Circles, Polygons, PolyLines). + +Until a split point is selected, the split point under the cursor will have a blue marker. + +\n If the object being split is a Polyline, the split will either result in a Straight Line and a PolyLine or two PolyLines depending on where the split is along the line. (PolyLines must always have at least 2 segments). + +\n Filled Circles and Polygons will be unfilled after the split. + +\n If the split object is a Circle, the result is an circular arc split at the point with a small (5 degree) gap. + +\n If the split object is a Polygon, a PolyLine with two end points at the split results. + +\rule + +\S2{cmdTrimDraw} Trim a Draw Object using another Draw object + +The \f{Trim Draw} command can be used to trim many draw objects (Straight Lines, Curved Lines, Circles, Polygons, PolyLines). Polygons and Circles are split into PolyLines and Curves. + +\n First a Trimming object (draw object) is selected with \f{Left-Click}. Until the trim draw object is selected, a draw object under the cursor will be highlit in blue. Once it is selected it will be highlit in the current Select Color. + +\n Next the point of intersection between the trim object and an object to be trimmed is selected. Until a split point is selected, a suitable split point under the cursor will have a blue trim anchor that is a T shape aligned with the trimming object. + +The trim anchor base has an arm that indicates which side of the trimmed object will be deleted. A \f{Left-Click} will trim the object. + +\u000 + +If the trimmed object is a circle or a polygon, the result will be the same as a Split (\K{cmdSplitDraw}), a 355 degree circle and an open polyline with ends at the split will result. + +Once a trim has occured, the trimming object remains selected for another trim. + +To leave the command use the spacebar. If \e{Sticky} (\K{cmdSticky}) is set for Split commands you will be able to select another trim object. + +\rule + + diff --git a/app/doc/clean-html.cmake b/app/doc/clean-html.cmake new file mode 100644 index 0000000..3b0c500 --- /dev/null +++ b/app/doc/clean-html.cmake @@ -0,0 +1,6 @@ +file(GLOB_RECURSE all_files *) + +if(all_files) + file(REMOVE ${all_files}) +endif(all_files) + diff --git a/app/doc/clean-html.cmake.in b/app/doc/clean-html.cmake.in deleted file mode 100644 index d3b6908..0000000 --- a/app/doc/clean-html.cmake.in +++ /dev/null @@ -1,6 +0,0 @@ -FILE(GLOB_RECURSE ALL_FILES *) - -IF(ALL_FILES) - FILE(REMOVE ${ALL_FILES}) -ENDIF(ALL_FILES) - diff --git a/app/doc/drawm.but b/app/doc/drawm.but index 76335bc..5e27011 100644 --- a/app/doc/drawm.but +++ b/app/doc/drawm.but @@ -32,6 +32,10 @@ Functions for drawing basic shapes and objects like lines and curves can be acce \u000 +\dd \f{Protractor} - create protractor and set visibility (\K{cmdAngle}) + +\u000 + \dd \f{Shapes} - draw boxes, polygons and poly-lines. (\K{cmdDrawShapes}) \u000 @@ -46,10 +50,13 @@ Some commands display controls on the Status Line (\K{mainW}) to change line wid \rule -\S{cmdDrawCircles} Circles and Filled Circles +\S{cmdDrawCircles} \i{Circles and Filled Circles} \G{png.d/mdrawcircles.png} +Before a Circle is drawn its line width and color can be set. For Filled Circles, the color can be set. +The \f{Circle Line Width} field is a scaled dimension in inches if >0. If 0 it is a 1 pixel wide line at all zooms. If the value is negative, it is a scale-independent number of pixels wide. + \f{Circles} and \f{Filled Circles} are created by selecting either the center position or a point on the edge of the circle and dragging to specify the radius. \dd \K{cmdDrawCircleTangent}. Draw a Circle from the Edge. @@ -68,42 +75,45 @@ Some commands display controls on the Status Line (\K{mainW}) to change line wid \rule -\S2{cmdDrawCircleTangent} Draw Circle from Tangent +\S2{cmdDrawCircleTangent} \i{Draw Circle from Tangent} -\G{png.d/dcircle2.png} +\G{png.d/dcircle3.png} -\c{Left-Drag} a point on the edge of the circle to specify the radius. +\c{Left-Drag} a point from the edge of the circle to the center to specify the radius. \rule -\S2{cmdDrawCircleCenter} Draw Circle from Center +\S2{cmdDrawCircleCenter} \i{Draw Circle from Center} -\G{png.d/dcircle3.png} +\G{png.d/dcircle2.png} -\c{Left-Drag} from the center of the circle to the edge. +\c{Left-Drag} from the center of the circle to the edge to specify the radius. \rule -\S2{cmdDrawFilledCircleTangent} Draw Filled Circle from Tangent +\S2{cmdDrawFilledCircleTangent} \i{Draw Filled Circle from Tangent} -\G{png.d/dflcrcl2.png} +\G{png.d/dflcrcl3.png} -\c{Left-Drag} from the center of the circle to the edge. +\c{Left-Drag} from the edge of the circle to the center to specify the radius. \rule -\S2{cmdDrawFilledCircleCenter} Draw Filled Circle from Center +\S2{cmdDrawFilledCircleCenter} \i{Draw Filled Circle from Center} -\G{png.d/dflcrcl3.png} +\G{png.d/dflcrcl2.png} -\c{Left-Drag} a point on the edge of the circle to specify the radius. +\c{Left-Drag} a point from the center to the edge of the circle to specify the radius. \rule -\S{cmdDrawCurves} Curved Lines +\S{cmdDrawCurves} \i{Curved Lines} \G{png.d/mdrawcurve.png} +Before a Curved Line is created, its width and color can be set. +The \f{Curved Line Width} or \f{Bezier Line Width} field is a scaled dimension in inches if >0. If 0 it is a 1 pixel wide line at all zooms. If the value is negative, it is a scale-independent number of pixels wide. + \f{Curved Lines} are created in the same manner as curved tracks. \dd (\K{cmdDrawCurveEndPt}). Drag out the end point and then curve it. @@ -124,54 +134,64 @@ Some commands display controls on the Status Line (\K{mainW}) to change line wid \dd (\K{cmdDrawBezierCurve} \G{png.d/dbezier.png} \e{Left-Drag} out control point from one end of the curve and then \e{Left-Drag} out the second control point from the other end. -If \f{MagneticSnap} is enabled, the curve ends will snap to the nearest part of nearby Draw objects unless \e{Alt} is held. -If it is disabled, snapping will only occure if \e{Alt} is held. +If \f{MagneticSnap} (\K{cmdMagneticSnap}) is enabled, the curve ends will snap to the nearest part of nearby Draw objects unless \e{Alt} is held. +If Magnetic Snap is disabled, snapping to objects will only occur if \e{Alt} is held. -The precise values of Radius and Arc Length can be set using the text boxes on the bottom rail once the mouse button is released. +If \f{Grid Snap} is on and magnetic snap does not find a draw object, the curve ends will snap to the grid. \e{Alt} suppresses this snap. -To adjust the curve, \e{Left-Click} and \e{Left-Drag} an end or a the radius. Hit \e{Enter} or \e{Space} to accept, \e{Esc} to reject. +If \e{Sticky} is set for curved line objects, after the curve is drawn there will be two text fields on the bottom rail, to allow fine-tuning of the radius and the arc angle. +Pressing \c{Enter} or \c{Tab} with the cursor in these boxes will apply the new values to the curve. Pressing \c{Space} or \c{Enter} or \c{Tab} on the drawing surface will move to drawing a new curve. +Pressing \c{Shift+Tab} with the cursor on the drawing surface will remove the current curve, but allow a new curve to be drawn. +Even if \c{Esc} is pressed, the curve will already exist, it can be removed with \f{Undo}. + +To adjust the curve with the mouse, \e{Left-Click} and \e{Left-Drag} an end or a the radius. Hit \e{Enter} or \e{Space} to accept, \e{Esc} to reject. \rule -\S2{cmdDrawCurveEndPt} Draw Curve from End Point +\S2{cmdDrawCurveEndPt} \i{Draw Curve from End Point} \G{png.d/dcurve1.png} \c{Left-drag} from the start of the curve and drag in the direction of the curve. Then \c{left-drag} to form the curve. -If the cursor is over a Draw object and \f{MagneticSnap} is on, the first position will snap to the nearest part of that object. If \e{Alt} is held the snap will be suppressed. -If \f{MagneticSnap} is disabled, the snap will happen if \e{Alt} is held. The second end will act similarly. +If the cursor is over a Draw object and \f{MagneticSnap} (\K{cmdMagneticSnap}) is on, the first position will snap to the nearest part of that object. If \e{Alt} is held the snap will be suppressed. +If \f{MagneticSnap} is disabled, the snap will happen if \e{Alt} is held. If \f{GridSnap} is enabled and MagneticSnap does not find a postion, the first position will snap to the Grid. This is +suppressed if \f{Alt} is held. The second end will act similarly. \rule -\S2{cmdDrawCurveTangent} Draw Curve from Tangent +\S2{cmdDrawCurveTangent} \i{Draw Curve from Tangent} \G{png.d/dcurve2.png} Select one end of the curve and \c{left-drag} to the center. Then \c{left-drag} the curve around the center. -The first and second ends will act like \K{cmdDrawCurveEndPt} with \f{MagneticSnap} unless \e{Alt} is held. +The first and second ends will act like \K{cmdDrawCurveEndPt} with \f{MagneticSnap} (\K{cmdMagneticSnap}) unless \e{Alt} is held. +If \f{GridSnap} is enabled and MagneticSnap does not find a postion, the first position will snap to the Grid. This is +suppressed if \f{Alt} is held. + To complete the command, drag on the red arrows to adjust the curve from the initial end. \rule -\S2{cmdDrawCurveCenter} Draw Curve from Center +\S2{cmdDrawCurveCenter} \i{Draw Curve from Center} \G{png.d/dcurve3.png} -Select the center of the curve and \c{left-drag} to one end. +Select the center of the curve and \c{left-drag} to one end. If \f{GridSnap} is enabled, the first position will snap to the Grid. This is +suppressed if \f{Alt} is held. \rule -\S2{cmdDrawCurveChord} Draw Curve from Chord +\S2{cmdDrawCurveChord} \i{Draw Curve from Chord} \G{png.d/dcurve4.png} \c{Left-drag} from one end of the curve to the other to form the chord of the curve. -The first and second ends will act like \K{cmdDrawCurveEndPt} with \f{MagneticSnap} unless \e{Alt} is held. +The first and second ends will act like \K{cmdDrawCurveEndPt} with \f{MagneticSnap} (\K{cmdMagneticSnap}) and \f{SnapGrid} unless \e{Alt} is held. If the mouse is over a draw object the second position will snap to the nearst part of that object. If \e{Shift} is held the snap will be suppressed. @@ -179,18 +199,18 @@ To complete the command, drag on the red arrows to adjust the curve. \rule -\S2{cmdDrawBezierCurve} Draw Bezier Curve +\S2{cmdDrawBezierCurve} \i{Draw Bezier Curve} \G{png.d/dbezier.png} \e{Left-Drag} out control point from one end of the curve and then \e{Left-Drag} out the second control point from the other end. Repeat for the other end and control point. -The first and second ends will act like \K{cmdDrawCurveEndPt} with \f{MagneticSnap} unless \e{Alt} is held. +The first and second ends will act like \K{cmdDrawCurveEndPt} with \f{MagneticSnap} and \f{SnapGrid} unless \e{Alt} is held. \rule -\S{cmdNote} Note Variants +\S{cmdNote} \i{Note Variants} \G{png.d/mnote.png} @@ -208,11 +228,12 @@ The \f{Note} command allows you to \rule -\S2{cmdTextNote} Plain Text +\S2{cmdTextNote} \i{Text Note} \G{png.d/bnote.png} \G{png.d/iconnote.png} Click and drag on the Main Canvas (\K{mainW}) to place the note. When you release, the \e{Note Editor} dialog is displayed. You can enter the note in the text area. +Text is limited to about 10 thousand characters. \G{png.d/notetext.png} @@ -220,7 +241,7 @@ When in \f{Properties} (\K{cmdDescribe}) mode, clicking on a \e{Note} will displ \rule -\S2{cmdLinkNote} Weblink +\S2{cmdLinkNote} \i{Weblink} \G{png.d/blink.png} \G{png.d/iconlink.png} Similar to text notes you can place a weblink on the layout. @@ -240,7 +261,7 @@ Double clicking on a weblink icon opens the website in your default browser. \rule -\S2{cmdFileNote} Document +\S2{cmdFileNote} \i{Document} \G{png.d/bfile.png} \G{png.d/iconfile.png} Similar to text notes you can place a reference to a file on the layout. @@ -258,7 +279,7 @@ Double clicking on a document reference icon opens the document in the default \rule -\S{cmdRuler} Ruler +\S{cmdRuler} \i{Ruler} \G{png.d/bruler.png} @@ -270,8 +291,22 @@ Subsequent clicks on the \f{Ruler} button will hide or display the ruler. \rule +\S{cmdAngle} \i{Protractor} + +\G{png.d/bangle.png} + +The \f{Angle} command displays a \e{Protractor} on the layout. Click for the protractor origin and \c{left-drag} the cursor to set the base angle. Adding \c{Ctrl} will snap the angle to a multiple of 90 degrees. + +Then \{Left-Drag the second line. Adding \c{Ctrl} will snap the angle to 90 degree relative to the base line. The angle between the lines is displayed. + +Sunsequent clicks on the \f{Angle} button will hide or display the \e{Protractor}. -\S{cmdDrawShapes} Shapes +The points of the \e{Protractor} can be modified using the \f{Modify} (\K{cmdModify}) command. + +\rule + + +\S{cmdDrawShapes} \i{Draw Shapes} \G{png.d/mdrawshapes.png} @@ -298,27 +333,29 @@ Shapes are drawn by: \u000 +If \e{Sticky} is set for many draw line and curve objects, after the object is created, precise dimensions can be entered to alter the new object, before it is completed either with a \c{Space} or \c{Return} or \c{Tab} or by selecting a new operation. -If \e{Sticky} is set for draw line and curve objects, after the object is created, precise dimensions can be entered to alter the new object, before it is completed either with a \c{Space} or \c{Return} or by selecting a new operation. - -The \f{Polygon} and \f{PolyLine} shapes are finished by pressing the \c{Space} or \c{Return} key or by selecting another operation. Before they are finished, precise dimensions can be entered for the last side drawn. +The \f{Polygon} and \f{PolyLine} shapes are finished by pressing the \c{Space} or \c{Return} \c{Tab} key or by selecting another operation. Before they are finished, precise dimensions can be entered for the last side drawn. All Polylines and Polygons must have more than 2 corners to be created successfully. Note that \K{cmdModify} can be used on a Polygon or a Polyline after it has been finished to alter individual points and to make them curved or rounded points. \rule -\S2{cmdDrawBox} Draw Box +\S2{cmdDrawBox} \i{Draw Box} \G{png.d/dbox.png} +Before the box is drawn, the line width and color can be specified. +The \f{Box Line Width} field is a scaled dimension in inches if >0. If 0 it is a 1 pixel wide line at all zooms. If the value is negative, it is a scale-independent number of pixels wide. + \f{Boxes} are created by selecting one corner and dragging the opposite corner. \u000 \rule -\S2{cmdDrawFilledBox} Draw Filled Box +\S2{cmdDrawFilledBox} \i{Draw Filled Box} \G{png.d/dfilbox.png} @@ -328,14 +365,17 @@ Note that \K{cmdModify} can be used on a Polygon or a Polyline after it has been \rule -\S2{cmdDrawPolygon} Draw Polygon +\S2{cmdDrawPolygon} \i{Draw Polygon} \G{png.d/dpoly.png} +Before the polygon is started the line width and color can be set. +The \f{PolyGon Line Width} field is a scaled dimension in inches if >0. If 0 it is a 1 pixel wide line at all zooms. If the value is negative, it is a scale-independent number of pixels wide. + \f{Polygons} are created by either a series for \c{Left-Click}s or \c{Left+Drag}s, and a new "node" is placed for each. When using \c{Left-drag}, the node will be positioned when you release the button. -\dd If \f{MagneticSnap} is enabled, An anchor point will be shown on nearby draw objects that the next point will be snapped to unless \c{Alt} is held. +\dd If \f{MagneticSnap} (\K{cmdMagneticSnap}) is enabled, An anchor point will be shown on nearby draw objects that the next point will be snapped to unless \c{Alt} is held. \dd If it is disabled, the snap will only occur if \e{Alt} is held. @@ -352,16 +392,18 @@ On the first polygon side this will be at a multiple of 90 degrees to the axes. \rule -\S2{cmdDrawFilledPolygon} Drae Filled Polygon +\S2{cmdDrawFilledPolygon} \i{Draw Filled Polygon} \G{png.d/dfilbox.png} +Before the Polygon is started, the fill color can be set. + \f{Filled Polygons} are created by either a series for \c{Left-Click}s or \c{Left+Drag}s, and a new "node" is placed for each. When using \c{Left-drag}, the node will be positioned when you release the button. \dd The fill color can be adjusted using the color control at the bottom of the window -\dd If \f{MagneticSnap} is enabled, An anchor point will be shown on nearby draw objects that the next point will be snapped to unless \c{Alt} is held. +\dd If \f{MagneticSnap} (\K{cmdMagneticSnap}) is enabled, An anchor point will be shown on nearby draw objects that the next point will be snapped to unless \c{Alt} is held. \dd If it is disabled, the snap will only occur if \e{Alt} is held. @@ -380,14 +422,17 @@ On the first polygon side this will be at a multiple of 90 degrees to the axes. \rule -\S2{cmdDrawPolyline} Draw PolyLine +\S2{cmdDrawPolyline} \i{Draw PolyLine} -\G{png.d/dpolyline} +\G{png.d/dpolylin.png} + +Before the polygon is started the line width and color can be set. +The \f{Polyline Line Width} field is a scaled dimension in inches if >0. If 0 it is a 1 pixel wide line at all zooms. If the value is negative, it is a scale-independent number of pixels wide. \f{PolyLines} are created by either a series for \c{Left-Click}s or \c{Left+Drag}s, and a new "node" is placed for each. When using \c{left-drag}, the node will be positioned when you release the button. -\dd If \f{MagneticSnap} is enabled, An anchor point will be shown on nearby draw objects that the next point will be snapped to unless \c{Alt} is held. +\dd If \f{MagneticSnap} (\K{cmdMagneticSnap}) is enabled, An anchor point will be shown on nearby draw objects that the next point will be snapped to unless \c{Alt} is held. \dd If it is disabled, the snap will only occur if \e{Alt} is held. @@ -414,7 +459,7 @@ On the first polyline segemnt this will be at a multiple of 90 degrees to the ax \rule -\S{cmdDrawStraights} Straight Objects +\S{cmdDrawStraights} \i{Straight Objects} \G{png.d/mdrawstraight.png} @@ -428,43 +473,50 @@ Straight Objects are created by a \e{Left+Drag} (\K{windowTerms}) on the layout. \u000 -\dd (\K{cmdDrawBench}). Creates \i\f{Bench-work} using different types and orientation of lumber. +\dd (\K{cmdDrawBench}). Creates \i{Bench-work} using different types and orientation of lumber. \u000 \dd (\K{cmdDrawTableEdge}). Creates a \f{Table Edge} -\S2{cmdDrawLine} Draw Straight Line +\S2{cmdDrawLine} \i{Draw Straight Line} + +\G{png.d/dline.png} -\G{png.d/dline.png} Creates a \f{Straight Line} of specified color and width. +Creates a \f{Straight Line} of specified color and width. +The \f{Straight Line Width} field is a scaled dimension in 75ths of an inch if >0. If 0 it is a 1 pixel wide line at all zooms. If the value is negative, it is a scale-independent number of pixels wide. -If \c{Ctrl} is held down during \c{Left+Drag} the line will snap the relative angle of the new side to a multiple of 90 degrees. +If \c{Ctrl} is held down during \c{Left+Drag} the line will snap the angle of the new side to a multiple of 90 degrees. -If \e{Sticky} is set for draw line and curve objects, after the object is created, precise dimensions can be entered to alter the new object, -before it is completed either with a \c{Space} or \c{Return} or \c{Tab} or by selecting a new operation. +With \f{MagneticSnap} (\K{cmdMagneticSnap}) enabled, the new line start position will snap to the nearest draw object, as shown by the anchor. If \c{Alt} is held down, the magnetic Snap is reversed. +If \f{GridSnap} is enabled and MagneticSnap does not find a postion, the first position will snap to the Grid. This is suppressed if \f{Alt} is held. -With \f{MagneticSnap} enabled, the new line start position will snap to the nearest draw object, as shown by the anchor unless \c{Shift} is held down. -If it is diabled, it will onlt snap if \e{Shift} is held. +The \f{Width} field is a scaled dimension in inches if >0. If 0 it is a 1 pixel wide line at all zooms. If the value is negative, it is a scale-independent number of pixels wide. + +If \e{Sticky} is set for straight draw, after the line is drawn there will be two text fields on the bottom rail, to allow fine-tuning of the angle and the length. +Pressing \c{Enter} or \c{Tab} with the cursor in these boxes will apply the value to the line. Pressing \c{Space} or \c{Enter} on the drawing surface will move to drawing a new line. +Pressing \c{Shift+Tab} will remove the current object and allow a new one to drawn. +Even if \c{Esc} is pressed, the line will already exist, it can be removed with \f{Undo}. \rule -\S2{cmdDrawDimLine} Draw Dimension Line +\S2{cmdDrawDimLine} \i{Draw Dimension Line} \G{png.d/ddimlin.png} Creates a \f{Dimension Line} of various sizes. -With \f{MagneticSnap} enabled, the new line start position will snap to the nearest draw object, as shown by the anchor unless \c{Shift} is held down. -If it is disabled, it will onlt snap if \e{Shift} is held. -If \c{Ctrl} is held down during \c{Left+Drag} the line will snap the relative angle of the new side to a multiple of 90 degrees. -If \e{Sticky} is set for draw line and curve objects, after the object is created, precise dimensions can be entered to alter the new object, -before it is completed either with a \c{Space} or \c{Return} or \c{Tab} or by selecting a new operation. +With \f{MagneticSnap} (\K{cmdMagneticSnap}) enabled, the new line start position will snap to the nearest draw object, as shown by the anchor unless \c{Alt} is held down. +If it is disabled, it will only snap if \e{Alt} is held. If \f{GridSnap} is enabled and MagneticSnap does not find a postion, the first position will snap to the Grid. This is +suppressed if \f{Alt} is held. + +If \c{Ctrl} is held down during \c{Left+Drag} the line will snap the angle of the new side to a multiple of 90 degrees. -\S2{cmdDrawBench} Draw Benchwork. +\S2{cmdDrawBench} \i{Draw Benchwork} \G{png.d/dbench.png} -Creates \i\f{Bench-work} using different types and orientation of lumber. +Creates \i{Bench-work} using different types and orientation of lumber. \i{Bench-work Notes} @@ -478,33 +530,44 @@ Creates \i\f{Bench-work} using different types and orientation of lumber. \dd When using metric units (\K{cmdPref}), a 1" x 2" is labeled 50mm x 25mm -With \f{MagneticSnap} enabled, the new line start position will snap to the nearest draw object, as shown by the anchor unless \c{Shift} is held down. -If it is diabled, it will onlt snap if \e{Shift} is held. -If \c{Ctrl} is held down during \c{Left+Drag} the line will snap the relative angle of the new side to a multiple of 90 degrees. -If \e{Sticky} is set for draw line and curve objects, after the object is created, precise dimensions can be entered to alter the new object, -before it is completed either with a \c{Space} or \c{Return} or \c{Tab} or by selecting a new operation. +With \f{MagneticSnap} (\K{cmdMagneticSnap}) enabled, the new line start position will snap to the nearest draw object, as shown by the anchor unless \c{Alt} is held down. +If it is disabled, it will only snap if \e{Alt} is held. If \f{GridSnap} is enabled and MagneticSnap does not find a postion, the first position will snap to the Grid. This is +suppressed if \f{Alt} is held. + +If \c{Ctrl} is held down during \c{Left+Drag} the line will snap the angle of the new side to a multiple of 90 degrees. -\S2{cmdDrawTableEdge} Draw Table Edge +If \e{Sticky} is set for straight draw, after the benchwork is drawn there will be two text fields on the bottom rail, to allow fine-tuning of the angle and the length. +Pressing \c{Enter} or \c{Tab} with the cursor in these boxes will apply the value to the benchwork. Pressing \c{Space} or \c{Enter} or \c{Tab} on the drawing surface will move to drawing a new benchwork line. +Pressing \c{Shift+Tab} on the drawing surface will remove the current object and allow a new one to be drawn. +Even if \c{Esc} is pressed, the benchwork will already exist, it can be removed with \f{Undo}. + +\S2{cmdDrawTableEdge} \i{Draw Table Edge} \G{png.d/dtbledge.png} Creates a \f{Table Edge} -With \f{MagneticSnap} enabled, the new line start position will snap to the nearest draw object, as shown by the anchor unless \c{Shift} is held down. -If it is diabled, it will onlt snap if \e{Shift} is held. -If \c{Ctrl} is held down during \c{Left+Drag} the line will snap the relative angle of the new side to a multiple of 90 degrees. -If \e{Sticky} is set for draw line and curve objects, after the object is created, precise dimensions can be entered to alter the new object, -before it is completed either with a \c{Space} or \c{Return} or \c{Tab} or by selecting a new operation. +With \f{MagneticSnap} (\K{cmdMagneticSnap}) enabled, the new line start position will snap to the nearest draw object, as shown by the anchor unless \c{Alt} is held down. +If it is disabled, it will only snap if \e{Alt} is held. If \f{GridSnap} is enabled and MagneticSnap does not find a postion, the first position will snap to the Grid. This is +suppressed if \f{Alt} is held. + +If \c{Ctrl} is held down during \c{Left+Drag} the edge will to a end point of another table edge or to a multiple of 90 degrees if that isn't available. + +If \e{Sticky} is set for straight draw, after the edge is drawn there will be two text fields on the bottom rail, to allow fine-tuning of the angle and the length. +Pressing \c{Enter} or \c{Tab} with the cursor in these boxes will apply the value to the edge. Pressing \c{Space} or \c{Enter} or \c{Tab} on the drawing surface will move to drawing a new edge. +Pressing \c{Shift+Tab} on the drawing surface will remove the current object and allow a new one to be drawn. +Even if \c{Esc} is pressed, the edge will already exist, it can be removed with \f{Undo}. \rule -\S{DrawOrigin} Draw Objects Origin +\S{DrawOrigin} \i{Draw Objects Origin} -Some objects have a natural rotation point within them. By setting the origin to this point, subsequent rotation will be about that point and not the layout origin. -This is referred to as a \e{Relative} origin. -When one of these is moved or rotated, the origin and angle are adjusted but the relative draw point values remain the same. +Some objects will a natural rotation point within them. By setting the object origin to this point, subsequent rotation will be about that point and not the layout origin. +This is referred to as a \e{Relative} origin and will be present if the origin is non-zero. +When an object with a Relative is moved or rotated, the origin and angle are adjusted but the relative draw point values remain the same. +If an object has a zero origin, it is called Absolute. If it is moved or rotated, the origin and angle remain zero, but all the obect point(s) are adjusted. -You can choose to set the origin to make it Relative or put it back to Absolute during \K{cmdDrawShapes} or \K{cmdModify} or by using the \K{cmdDescribe} settings. +You can choose to set the origin to make it Relative or put it back to Absolute (origin zero) during \K{cmdDrawShapes} or \K{cmdModify} or by using the \K{cmdDescribe} settings. As a practical matter, the object will appear identical until a subsequent rotation value is entered in the \K{cmdDescribe} window in both cases. @@ -521,21 +584,27 @@ In Origin Mode (entered using \c{'o'} or the Context Menu, there are certain sho \dd \c{'m'} Move the Relative Origin to the middle of the shape (centeroid). -\S{cmdText} Text +\S{cmdText} \i{Text} \G{png.d/btext.png} -The \f{Text} command lets you enter text on the layout at the selected position. You can use the Tab key to format the text to fixed tab positions and CTRL+Enter to enter a newLine character. +The \f{Text} command lets you enter a Text Draw object on the layout at the selected position. You can use the Tab key to format the text to fixed tab positions and CTRL+Enter to enter a newLine character. \G{png.d/statustext.png} -The font size can be changed by the Font Size drop list on the \f{Status-bar} (\K{mainW}). The font size is scaled along with everything else on the layout so text is always the same relative size as other layout objects. +The font size can be changed by the Font Size drop list on the \f{Status-bar} (\K{mainW}). The font size is scaled along with everything else on the layout so text is always the same relative size as other layout objects. + +The color used can be selected by the Color icon on the \f{Status-bar} (\K{mainW}). + +The new text object can be "boxed" by having a line drawn around it using the Boxed tick-mark on the \f{Status-bar} (\K{mainW}). + +The position where text is to be placed on the layout is selected prior to text entry by \c{Left-Click}ing on the layout at the point where the text is to appear. Desired text is input after the position is selected. If necessary, the location can be changed once text entry begins by \c{Left-Click+Drag}ing the text to any desired postion on the layout. -The font can be selected by the \f{Font Selection} (\K{fontSelW}) dialog invoked by the \f{Options>Fonts} menu item or by \c{Shift+Right-Click} (\K{cmdAcclKeys}). +The \f{Properties} (\K{cmdDescribe}) command can be used to modify the contents, color and fontsize of existing \f{Text} objects and to set the boxes property. -The position where text is to be placed on the layout must be selected prior to text entry. The position is select by \c{Left-Click}ing on the layout at the point where the text is to appear. Desired text is entered after the position is selected. If necessary, the location can be changed once text entry begins by \c{Left-Click+Drag}ing the text to any desired postion on the layout. +The new Text object is committed when another command is entered (or \e{Enter} is used if the Text command is Sticky). -The \f{Properties} (\K{cmdDescribe}) command can be used to modify the contents of existing \f{Text} objects and to draw boxes around them. +The font used for all Text objects can be selected by the \f{Font Selection} (\K{fontSelW}) dialog invoked by the \f{Options>Fonts} menu item or by \c{Shift+Right-Click} (\K{cmdAcclKeys}). Note: loading fonts (or changing sizes) can take a noticeable amount of time. diff --git a/app/doc/editm.but b/app/doc/editm.but index 166ec11..5702321 100644 --- a/app/doc/editm.but +++ b/app/doc/editm.but @@ -10,87 +10,109 @@ The \f{Edit Menu} shows commands affecting the \f{Main Canvas} (\K{mainW}). -\dd \f{Above} - Moves selected object to foreground. +\dd \i{Undo} - Reverses the last command. Up to the last ten commands can be undone. If there are no commands that can be undone the \f{Undo} item is disabled. The \f{Undo} command can also be invoked by the \f{Undo} button (\K{cmdUndo}). \u000 -\dd \f{Below} - Moves selected object to background. +\dd \i{Redo} - Undoes the last Undo command. The \f{Redo} command can also be invoked by the \f{Redo} button (\K{cmdUndo}). \u000 -\dd \f{Copy} - Copies the selected objects to the clipboard. +\dd \i{Cut} - Moves the selected objects to the clipboard. \u000 -\dd \f{Clone} - Copies the selected objects to the clipboard and duplicates them offset from the original. -Repeated Clone commands result in a series of offset copies. -The new objects are selected and the old ones un-selected. +\dd \i{Copy} - Copies the selected objects to the clipboard. \u000 -\dd \f{Cut} - Moves the selected objects to the clipboard. +\dd \i{Paste} - Copies the contents of the clipboard to the layout. Using the paste Menu command it will be placed at the center of the screen. +If the context menu paste is used or the short-cuts \e{Ctrl+v} or \e{Shift+Insert}, the parts will be placed at the cursor position. +Repeated Pastes without moving the cursor result in overlaid copies. +The newly pasted parts are in \f{Selected} state and can easily be moved into place. Any previously selected objects are unselected. \u000 -\dd \f{Delete} - Deletes the selected objects. +\dd \i{Delete} - Deletes the selected objects. \u000 -\dd \f{Deselect All} - unselects all objects on the layout. The same action can be achieved by pressing the ESC key. +\dd \i{Move To Current Layer} - move all selected objects to the current Layer (\K{cmdLayer}). \u000 -\dd \f{Invert Selection} - selects all unselected objects and unselects all previously selected objects. +\dd \i{Select All} - Selects all objects on the layout. \u000 -\dd \f{Move To Current Layer} - move all selected objects to the current Layer (\K{cmdLayer}). +\dd \i{Select Current Layer} - selects all objects in the current Layer (\K{cmdLayer}). \u000 -\dd \f{Paste} - Copies the contents of the clipboard to the layout. Using the paste Menu command it will be placed at the center of the screen. -If the context menu paste is used or the short-cuts \e{Ctrl+v} or \e{Shift+Insert}, the parts will be placed at the cursor position. -Repeated Pastes without moving the cursor result in overlaid copies. -The newly pasted parts are in \f{Selected} state and can easily be moved into place. Any previously selected objects are unselected. +\dd \i{Select By Index} - selects object by index number (\K{cmdSelectIndex}). + +\u000 + +\dd \i{Deselect All} - unselects all objects on the layout. The same action can be achieved by pressing the ESC key. \u000 -\dd \f{Redo} - Undoes the last Undo command. The \f{Redo} command can also be invoked by the \f{Redo} button (\K{cmdUndo}). +\dd \i{Invert Selection} - selects all unselected objects and unselects all previously selected objects. \u000 -\dd \f{Select All} - Selects all objects on the layout. +\dd \i{Select Stranded Track} - selects all track pieces that are not connected to any other objects. This helps cleaning up a drawing after many changes have been made. \u000 -\dd \f{Select Current Layer} - selects all objects in the current Layer (\K{cmdLayer}). +\dd \i{Tunnel}\I{Track, Tunnel} - Hides or reveals selected tracks and adds a tunnel portal symbol where the track passes from one to the other. \u000 -\dd \f{Select Stranded Track} - selects all track pieces that are not connected to any other objects. This helps cleaning up a drawing after many changes have been made. +\dd \i{Bridge}\I{Track, Bridge} - Adds or removes parapet symbols and a solid base to the track. The color is selectable (\K{cmdRgbcolor}). \u000 -\dd \f{Thin, Medium and Thick Tracks} - set displayed rail width of selected tracks. +\dd \i{Roadbed}\I{Track, Roadbed} - Adds or removes solid roadbed under the track. The color is selectable (\K{cmdRgbcolor}). \u000 -\dd \f{Tunnel} - Hides or reveals selected tracks and adds a tunnel portal symbol where the track passes from one to the other. +\dd \i{Ties/No Ties}\I{Track Ties}\I{Track No Ties} - Hides or reveals the ties on selected tracks. \u000 -\dd \f{Bridge} - Adds parapet symbols to the sides of the track. +\dd \i{Move To Front} - Moves selected object to foreground. \u000 -\dd \f{Undo} - Reverses the last command. Up to the last ten commands can be undone. If there are no commands that can be undone the \f{Undo} item is disabled. The \f{Undo} command can also be invoked by the \f{Undo} button (\K{cmdUndo}). +\dd \i{Move To Back} - Moves selected object to background. + +\u000 + +\dd \i{Thin, Medium and Thick Tracks} \I{Thin Tracks}\I{Medium Tracks} + \I{Thick Tracks}\I{Tracks, Thin}\I{Tracks, Medium}\I{Tracks, Thick} + \I{Track Width} + - set displayed rail width of selected tracks. + +\u000 For more information on working with selected objects, see the Select (\K{cmdSelect}) command. \rule +\S{cmdSelectIndex} \i{Select By Index} + +An input window allows one or more index numbers to be entered. Multiple indexes are seperated by commas. + +The object can not be selected if its Layer is frozen. + +If the object is part of a module layer, all objects in the layer will be selected. -\S{cmdAboveBelow} "Move To Front" and "Move to Back" +If the object is a tunnel object, and the Display Tunnel option is None, it will be set to Dashed. See Display options (\K{cmdDisplay}). + +When an individual object is selected, its index number is displayed in the Info Message area, another source is the List Parts (\K{cmdEnum}) command with the \f{List Indexes} option. + +\S{cmdAboveBelow} "Move To Front" and "Move to Back" \I{Move To Front} \I{Move To Back} \G{png.d/btop_bottom.png} @@ -107,19 +129,23 @@ Selected objects moved to the \f{Background} become unselected. Additional Shortcut keys perform the following: -\dd \c{Shift+Backspace} - Undo +\dd \c{Ctrl+Z} - Undo + +\u000 + +\dd \c{Ctrl+R} - Redo \u000 -\dd \c{Ctrl+Insert} - Copy +\dd \c{Ctrl+C} - Copy \u000 -\dd \c{Shift+Insert} - Paste +\dd \c{Ctrl+V} - Paste \u000 -\dd \c{Shift+Delete} - Cut +\dd \c{Ctrl+X} - Cut \u000 @@ -128,7 +154,7 @@ Additional Shortcut keys perform the following: \rule -\S{cmdDelete} Delete +\S{cmdDelete} \i{Delete} \G{png.d/bdelete.png} @@ -141,7 +167,7 @@ The \e{Delete} key invokes the Delete command. \rule -\S{cmdTunnel} Tunnel (Hide Tracks) +\S{cmdTunnel} \i{Tunnel (Hide Tracks)} \G{png.d/btunnel.png} @@ -153,32 +179,50 @@ A tunnel portal is drawn where a hidden track connects with an 'unhidden' track. The \f{Draw Tunnels} Radio button group on the \f{Options>Display} dialog (\K{cmdDisplay}) controls whether hidden tracks are not drawn, drawn as dashed lines or drawn as normal lines. + \rule +\S{cmdTies} \i{Ties (Draw or Hide Ties)} -\S{cmdBridge} Bridge (Draw Abutments) +\G{png.d/bties.png} -The \f{Bridge} command is used to add abutments to a track (as on an underbridge). +The \f{Ties} command is used to hide Ties (or reshow them). This may be useful for overlapping track, like dual gauge, or in areas like docks or yards where the track is covered. -Select the tracks you want to be a bridge. Bridge abutments are drawn alongside the track. You can split (\K{cmdSplitTrack}) a track to shorten the length of the bridge, or to add an extra pier to the drawing. +Select the tracks you want to hide or show ties for. -If you perform this action (or use Tunnel) the bridge is removed. \rule -\S{cmdTies} Ties (Draw or Hide Ties) +\S{cmdBridge} \i{Bridge (Draw or Hide Abutments)} -The \f{Ties} command is used to hide Ties (or reshow them). This may be useful for overlapping track, like dual gauge, or in areas like docks or yards where the track is covered. +\G{png.d/bbridge.png} + +The \f{Bridge} command is used to add abutments to a track (as on an underbridge). + +Select the tracks you want to be a bridge. Bridge abutments are drawn alongside the track and a solid layer is added under the ties. You can split (\K{cmdSplitTrack}) a track to shorten the length of the bridge, or to add an extra pier to the drawing. + +If you perform this action on an existing bridge (or use Tunnel) the bridge is removed. -Select the tracks you want to hide or show ties for. \rule +\S{cmdRoadbed} \i{Roadbed (Draw or Hide Base)} -\S{cmdUndo} Undo and Redo +\G{png.d/broadbed.png} + +The \f{Roadbed} command is used to add a solid color under a track (as roadbed). + +Select the tracks you want to have roadbed. A solid roadbed layer is drawn under the track. + +If you perform this action on existing roadbed (or use Tunnel) the roadbed is removed. The bridge option takes precedence over roadbed. + + +\rule + +\S{cmdUndo} Undo and Redo \I{Undo} \I{Redo} \G{png.d/bgundo.png} The \f{Undo} and \f{Redo} buttons invoke the same actions as the \f{Edit} menu items. The name of last command will be displayed as the Balloon Help (\K{windowTerms}) for the \e{Undo} button. The name of last undone command will be displayed as the Balloon Help for the \e{Redo} button. -\rule
\ No newline at end of file +\rule diff --git a/app/doc/filem.but b/app/doc/filem.but index a0cce82..31d40d3 100644 --- a/app/doc/filem.but +++ b/app/doc/filem.but @@ -25,15 +25,20 @@ The \f{File Menu} shows file oriented commands for loading and saving layout fil \u000 -\dd \f{Export} - Exports the selected objects to a file in \e{XTrackCAD} (*.xti) format. The exported file can then be imported into another layout design. Refer to the Import command listed below. +\dd \G{png.d/bexport.png} \f{Export} - Exports objects to a file in \e{XTrackCAD} (*.xti) format. If no objects are selected, all objects in visible layers are exported. If objects are selected they are exported. The exported file can then be imported into another layout design. Refer to the Import command listed below. \u000 -\dd \f{Export to Bitmap} - Creates a bitmap file (\K{cmdOutputbitmap}) of the layout. The bitmap will be saved in PNG format. +\dd \G{png.d/bexportbmap.png}\f{Export to Bitmap} - Creates a bitmap file (\K{cmdOutputbitmap}) of the layout. The bitmap can be saved in either JPEG or PNG format. \u000 -\dd \f{Export to DXF} - Exports the selected objects to a file in DXF format (\K{generalTerms}). The exported file can then be imported into other CAD programs. +\dd \G{png.d/bexportdxf.png}\f{Export to DXF} - Exports objects to a file in DXF format (\K{generalTerms}). If no objects are selected, all objects in visible layers are exported. If objects are selected they are exported. The exported file can then be imported into other CAD programs. + +\u000 + +\dd \G{png.d/bexportsvg.png} \f{Export to SVG} - Exports objects to a file in SVG format. If no objects are selected, all objects in visible layers are exported. If objects are selected they are exported. The exported file can then be imported into a vector drawing program like Inkscape +or used for publishing on the web. \u000 @@ -41,11 +46,11 @@ The \f{File Menu} shows file oriented commands for loading and saving layout fil \u000 -\dd \f{Import} - Displays the file selection dialog which allows selection of an existing \e{XTrackCAD} Import (\K{cmdExport} *.xti) files. This function can be used to transfer parts like a yard design from one layout design to another. +\dd \G{png.d/bimport.png} \f{Import} - Displays the file selection dialog which allows selection of an existing \e{XTrackCAD} Import (\K{cmdExport} *.xti) files. This function can be used to transfer parts like a yard design from one layout design to another. \u000 -\dd \f{Import Module} - Displays the file selection dialog which allows selection of an existing \e{XTrackCAD} Import (\K{cmdExport} *.xti) file. The imported parts are put into a empty layer, sets the layer name to the imported filename and sets the layer to be a module - see (\K{cmdLayer}). +\dd \G{png.d/bimportmod.png} \f{Import Module} - Displays the file selection dialog which allows selection of an existing \e{XTrackCAD} Import (\K{cmdExport} *.xti) file. The imported parts are put into a empty layer, sets the layer name to the imported filename and sets the layer to be a module - see (\K{cmdLayer}). \u000 \dd \G{png.d/bnew.png} \f{New} - Clears the current layout. In case there are any unsaved changes on the current plan, a warning pop-up will be displayed and you'll have the option to cancel the operation. After that the Layout Options (\K{cmdLayout}) dialog will be opened. @@ -60,19 +65,19 @@ The \f{File Menu} shows file oriented commands for loading and saving layout fil \u000 -\dd \f{Parameter Files} - Displays the \f{Parameter Files} dialog (\K{cmdPrmfile}) to choose parameter files. +\dd \G{png.d/bparam.png} \f{Parameter Files} - Displays the \f{Parameter Files} dialog (\K{cmdPrmfile}) to choose parameter files. \u000 -\dd \f{Print Setup} - Shows the Printer Setup Dialog (\K{printSetup}). +\dd \G{png.d/bsetup.png} \f{Print Setup} - Shows the Printer Setup Dialog (\K{printSetup}). \u000 -\dd \f{Print} - Invokes the Print command (\K{cmdPrint}). +\dd \G{png.d/bprint.png} \f{Print} - Invokes the Print command (\K{cmdPrint}). \u000 -\dd \f{Revert} - Undoes all changes and returns to the last saved layout plan. +\dd \G{png.d/brevert.png} \f{Revert} - Undoes all changes and returns to the last saved layout plan. \u000 @@ -80,12 +85,14 @@ The \f{File Menu} shows file oriented commands for loading and saving layout fil \u000 -\dd \f{Save As} - This command lets you make a copy of the track plan you are currently working on as an file (.xtc) or an archive (.xtce). It differs from the regular Save command. Save stores your data back into the folder (directory) it originally came from in the same filetype. "Save As" lets you give your plan a different name and/or put it in a different folder on your hard disk and chnage its filetype using the selection box at the bottom of the list of files or by hardcoding the extensions .xtc or .xtce (for an archive). +\dd \G{png.d/bsaveas.png} \f{Save As} - This command lets you make a copy of the track plan you are currently working on as an file (.xtc) or an archive (.xtce). It differs from the regular Save command. Save stores your data back into the folder (directory) it originally came from in the same filetype. "Save As" lets you give your plan a different name and/or put it in a different folder on your hard disk and chnage its filetype using the selection box at the bottom of the list of files or by hardcoding the extensions .xtc or .xtce (for an archive). \rule \S{cmdExport} \i{Export} +\G{png.d/bexport.png} + This menu item displays a file selection dialog where a file name for exported objects can be entered. All selected (\K{cmdSelect}) objects are exported to the file. The export file will have an \c{xti} extension. \G{png.d/exportfile.png} @@ -96,18 +103,27 @@ Using the Import command (\k{cmdImport}), an exported file can be imported into \S{cmdOutputbitmap} \i{Export to Bitmap} +\G{png.d/bexportbmap.png} + This menu item creates a bitmap file of the layout. \G{png.d/bitmap.png} -The \f{Bitmap} dialog specifies the style and size of the bitmap. The three check-boxes (\f{Print Titles}, \f{Print Borders} and \f{Print Centerline}) control whether the Layout Title (\K{cmdLayout}), the borders or the track centerlines are printed on the bitmap. The size of the bitmap is smaller if these are disabled. +The \f{Bitmap} dialog specifies the style and size of the bitmap. The check-boxes (\f{Layout Titles}, \f{Borders}, \f{Centerline of Track} and +\f{Background Image}) control +whether the Layout Title (\K{cmdLayout}), the borders or the track centerlines are printed on the bitmap. If a background image is used it will be +printed if the option is set. + + The size of the bitmap is smaller if these are disabled. Printing the track centerlines (also seen when zoomed in 1:1) is useful when you later print the bitmap full size for laying out track. If the Snap Grid (\K{cmdGrid}) is visible then it will be printed on the bitmap. -The \f{DPI} (or \f{DPCM} if using metric units (\K{cmdPref})) control specifies the number of pixels per inch (or centimeter) in the bitmap. You can enter values from 0.1 to 100. Larger values will result in a larger bitmap file. bitmaps must be less than 32000 pixels in height or width. +The \f{DPI} control specifies the number of pixels per inch in the bitmap. Bitmaps must be less than 32,000 pixels in height or width. +The upper value you can enter depends on the size of your trackplan. It is made sure that your bitmap does not exceed these limits. +Larger values will result in a larger bitmap file. The bitmap width, height and approximate file size is indicated. @@ -115,12 +131,15 @@ Note: This command can create a very large file and consume a lot of memory and Pressing the \f{OK} button invokes a \f{File Save} dialog so you can choose the file name for the Bitmap. -The format of the file is PNG on all operating systems. +You can select to create JPEG or PNG files. As a rule of thumb JPEG results in smaller files when you use a backgound image, PNG +does so for trackplans without an image background. \rule \S{ExportDXF} \i{Export to DXF} +\G{png.d/bexportdxf.png} + This menu item displays a file selection dialog where a file name for exported objects can be entered. All selected (\K{cmdSelect}) objects are exported to the file. The export file will have an \c{xti} extension. \G{png.d/exportfiledxf.png} @@ -129,7 +148,29 @@ Exported files can then be imported into other CAD programs. \rule -\S{cmdImport} Import +\S{ExportSVG} \i{Export to SVG} + +\G{png.d/bexportsvg.png} + +This menu item displays a file selection dialog where a file name for exported objects can be entered. All selected (\K{cmdSelect}) objects are exported to the file. The export file will have an \c{svg} extension. + +\G{png.d/exportfilesvg.png} + +Files in SVG format can be used for different purposes. + +\b SVG files can be loaded into many drawing programs. This makes it possible to enhance and resize the image. Vector images have the advantage of +allowing lossless resizing. + +\b Most modern browsers support SVG as an image format. So the resulting file can directly be used to publish your plan on the web. By adding a bit of +Javascript, zooming and panning can be enabled. Appropiate scripts can easily be found using your favorite search engine. +The generated SVG uses the layout description as a title that is shown by some browser. Also the drawing has an 'id' for manipulation by Javascript. +This id is derived from the filename by removing all spaces and sticking the word 'id' in front. Eg exporting \c{stonega.xtc} the resulting id will be \c{idstonega}. + +\rule + +\S{cmdImport} \i{Import} + +\G{png.d/bimport.png} Importing displays a file selection dialog to specify the file to import. @@ -139,8 +180,22 @@ After importing the objects from the file, the imported objects are in selected \rule +\S{cmdImportM} \i{Import as Module} + +\G{png.d/bimportxtc.png} + +Importing displays a file selection dialog to specify the file to import as a module. + +\G{png.d/importmod.png} + +After importing the objects from the file, the imported objects are in selected state and therefore are drawn in red. This allows you to easily move and rotate the imported objects to their final position. + +\rule + \S{cmdPrmfile} \i{Parameter Files} +\G{png.d/bparam.png} + \e{Parameter Files} contain turnout, sectional track and structure definitions. Loaded Parameter Files are managed with the \f{Parameter Files} dialog. \G{png.d/dprmfile.png} @@ -149,47 +204,48 @@ The dialog contains a list of parameter files. Each file is preceded by a color are usable in the current scale and gauge. \G{png.d/greendot.png} \G{png.d/greenstar.png} Definitions from this file are a perfect fit for the current layout options. The file has been loaded and will be visible in the \f{HotBar}. For track this means that gauge and scale of the track elements -are identical to the layout settings. +are identical to the layout settings. Prototype definitions (Scale "*") are always a perfect fit. Turnouts and Sectional Track must have the same gauge and usually the same scale unless the scale/gauge combination has been defined to fit. +OO layouts use HO track as an example. \G{png.d/yellowdot.png} \G{png.d/yellowstar.png} Definitions from this file can be used with this layout but do not fit perfectly. A typical example is On30 where HO scale track can be used because the -gauge is the same. But differences in scale may make the track look out of scale. +gauge is the same. But differences in scale may make the track look out of scale. Structures are considered compatible if the scale is within +/-20%. Cars are compatible if the gauge is the same, but the scale can be +/-20%. +Exceptions to this can be defined in the scale definitions. \G{png.d/reddot.png} \G{png.d/redstar.png} This parameter file doesn't contain any usable definitions with current settings. You may want to change the layout options if you want to use elements from this file (for example altering the Layout Scale). \G{png.d/greydot.png} \G{png.d/greystar.png} This file is loaded but hidden. If it is marked as favorite it will be kept on the -list between runs. Otherwise it will be removed from the list when -the program is terminated. +list between runs. -Definition files can be marked as \e{favorite}. The indicator for favorites is a star. +Parameter files can be marked as \e{favorite}. The indicator for favorites is a star. The meaning of the colors isn't changed. -Loaded definition files that are marked with a yellow or a green indicator appear on the \f{Hot Bar} (\K{cmdHotBar}). +Loaded definition files that are marked with a yellow or a green indicator appear on the \f{Hot Bar} (\K{cmdHotBar}). -If you \e{unload} a file the definitions are removed from the selection lists and the \f{Hot Bar}. -If the unloaded file was marked as a favorite it can be \e{reloaded} by selecting the \f{Reload} button. +If you \e{unload} a file the definitions are removed from the selection lists and the \f{Hot Bar}. +If the unloaded file was marked as a favorite it can be \e{reloaded} by selecting the \f{Reload} button. -Files that are still loaded can be \e{reloaded} as well. In that case the old definitions are refreshed and extended by the -rereading the file. This can be useful if you want to check changes you made by hand-editing a parameter file. +Files that are still loaded can be \e{reloaded} as well. In that case the old definitions are refreshed and extended by the +rereading the file. This can be useful if you want to check changes you made by hand-editing a parameter file. Note that loading a file does not change the existing definitions in the layout. To do that after loading, use \K{cmdRefreshSpecial}. It is possible to change the state of several files at once. The \f{Select All} button allows you to select all parameter files for the next operation. -In case unloaded files are marked as favorite, their state will be preserved +In case unloaded files are marked as favorite, their state will be preserved between runs of the program. This makes it possible to keep a list of preferred parameter sets between runs of XTrackCAD but hide temporary unused files from the hotbar. That way the hotbar contents can be kept short containing only the currently needed elements. In order to update the defintion of an already loaded file from disk, you can use the \e{Reload} button. This will reload the file contents - with any changes made. -It is the equivalent of using \f{Browse} and selecting the file again. - +It is the equivalent of using \f{Browse} and selecting the file again. + Files can be listed by either their file name or by their contents description. This is controlled by the \f{Show File Names} check box. -The \f{Search} button opens the \e{Search Parameter File} dialog (\K{cmdSearchgui}) this +The \f{Library} button opens the \e{Choose Parameter File} dialog (\K{cmdSearchgui}) this shows the all files included the system library so they can be added. The \f{Browse} button opens a file window that allows the user to add additional files @@ -203,18 +259,23 @@ The order in this list controls the order of turnouts and structures on the \f{Hot Bar} (\K{cmdHotBar}). You can move a parameter file to the end of the list by \e{Unloading} it, and then loading it via the \f{Browse} button. -\S{cmdSearchgui} \i{Search Parameter Files} +\S{cmdSearchgui} \i{Choose Parameter Files} Selecting and loading additional parameter files from the System Library is done in the -\f{Search Parameter Files} dialog. +\f{Choose Parameter Files} dialog. \G{png.d/paramsearch.png} Using the Search function you can find and select parameter files that are part of the XTrackCAD installation. -Enter a search string and select the Search button. Search results are -shown in the list box. A blank search or the value "*" resets the search results to -show the entire libary. +Enter a set of one or more words and select the Search button. Search results are +shown in the list box. Pressing the \i{Clear Filter} button shows the complete +list again. + +You can subset the search to only search for parameter files who start with contents that fit the current Layout Scale using the \f{Fit} Mode. +The options are "Fit All", "Fit Compatible" and "Fit Exact". Fit Compatible means that structures with +Note that the code only looks at the first Turnout, Structure or Car entry to decide on the scale for the entire file. +They will correspond to the color icons on the Parameter Files menu once they are loaded \K{cmdPrmfile} when the same Layout scale is in use. Select the files you're interested in and press the \f{Add} button to add them to your parameter list. @@ -223,8 +284,14 @@ parameter list. \S{cmdPrint} \i{Printing} +\G{png.d/bprint.png} + The \f{Print} command (\f{File>Print}) is used to print all or a portion of the layout. +\G{png.d/bsetup.png} + +The \f{Print Setup} command (\f{File>Print Setup}) is used to set up the printer properties. + When the \f{Print} command is selected a grid, which represents each printed page, is drawn on the layout. Pages can be selected or unselected for printing by placing the mouse over a grid section and clicking the left mouse button. \G{png.d/print.png} @@ -279,7 +346,8 @@ Whether tracks are printed with one or two lines (representing the center line a \u000 -\dd \f{Page Numbers} - to help positioning the individual pages the page number is printed in the center of the page in the format (x/y). x is the position from left to right, y in from bottom to top, So (1/1) is the page at the bottom left. +\dd \f{Page Numbers} - to help positioning the individual pages the page number is printed in the center of the page in the format (x/y). +x is the page position from left to right, y in from bottom to top, So (1/1) is the page at the bottom left. As an additional aid, the numbers of the next pages are printed on each edge. \u000 @@ -288,7 +356,7 @@ As an additional aid, the numbers of the next pages are printed on each edge. \u000 -\dd \f{Rulers} - print rulers on all edges of the page. This option is only enabled if the \f{Angle} is \e{0.000}. +\dd \f{Rulers} - choose to print rulers at the layout edge, or on all edges of the page, an option is only enabled if the \f{Angle} is \e{0.000}, or None - which means print no rulers. \u000 @@ -349,7 +417,7 @@ If you make printouts in strips at different angles at 1:1 (to follow tracks aro \rule -\S{printSetup} Printer Setup +\S{printSetup} \i{Printer Setup} \S2{Linux} \i{Linux} @@ -377,6 +445,29 @@ The \f{Printer Setup} window contains: \dd \f{Cancel} - ends the dialog without update. +\u000 + +\e{Note} - +Printing uses a default of 600ppi. It scales the print and text from a default size of 72dpi. +This is often the expected value for a standard printer driver to work correctly, but will not work if the driver is not accurately setting the ppi available. +To override the printer ppi you can use either the configuration file settings for print or environmental variables. +These values are set in the Preferences section. +\u000 + +\n Preferences.PrintScale - The floating point ratio of the real printer dpi to 72. + +\n Preferences.PrintTextScale - The floating point ratio of the real printer text support to a dpi of 72. This value has no effect unless PrintScale is set to > 0.0. + +\u000 +These values can also be set using environmental variables if the configuration preference values are not set or they are set to <=0.0. +\u000 + +\n XTRKCADPRINTSCALE + +\n XTRKCADPRINTTEXTSCALE + +\u000 + \rule \S2{MS-Windows} \i{Microsoft Windows} @@ -423,7 +514,7 @@ The \f{Printer Setup} window contains: \G{png.d/printmargin.png} -The \f{Printer Margins} dialog allows you to configure the selected printer's margins. +The \f{Printer Margins} dialog allows you to configure the selected printer's margins. The margins for the four edges of the printed page are displayed. The default values are fetched from the Operating System. @@ -441,7 +532,7 @@ To check your printer's margin: \u000 -\dd Enable \f{Registration Marks} +\dd Enable \f{Registration Marks} this prints crosshairs every 3" or 10cm at scale 1:1. \u000 @@ -463,4 +554,8 @@ To check your printer's margin: Margins values are stored for each printer. +\u000 + +You can also load \f{PrinterMarginTest-A4.xtc} or \f{PrinterMarginTest-Letter.xtc} from \f{Help|Examples}. These files have registration lines in the corners to help determine your printer's margins. + \rule diff --git a/app/doc/helpm.but b/app/doc/helpm.but index b1e3666..38911f3 100644 --- a/app/doc/helpm.but +++ b/app/doc/helpm.but @@ -20,6 +20,15 @@ The \f{Help Menu} displays information on various topics. The contents of the me The \f{Recent Messages} command opens a cascading menu containing recent error messages and notices you have received. Selecting one of them displays additional information about the message (\K{messageList}). +The \f{Collect Problem Info} command helps you to put together the information and files that might help the developers to analyze and fix possible bugs. + +\dd \G{png.d/problemdata.png} + +\dd \e{Collect Problem Info} + +The command removes userids and other private information from the files. The results are stored in a compressed (zip-) file and placed in the same +directory as the affected layout file. + \dd \G{png.d/dtipofday.png} \dd \e{Tip of The Day} @@ -36,7 +45,7 @@ The \f{Examples} command displays the list of included example programs which yo \rule -\S{cmdDemo} Demo Mode +\S{cmdDemo} \i{Demo Mode} The \f{Demos} menu item, under the \f{Help} (\K{helpM}) menu, shows a cascading menu of choices to demonstrate various features and commands. diff --git a/app/doc/hhc.cmake.in b/app/doc/hhc.cmake.in index e9f0656..947b1da 100644 --- a/app/doc/hhc.cmake.in +++ b/app/doc/hhc.cmake.in @@ -1,9 +1,9 @@ -EXECUTE_PROCESS( +execute_process( COMMAND "@HTML_HELP_COMPILER@" xtrkcad.hhp - RESULT_VARIABLE RESULTS - OUTPUT_VARIABLE OUTPUT - ERROR_VARIABLE ERROR + RESULT_VARIABLE results + ERROR_VARIABLE error ) -MESSAGE("${OUTPUT}") -MESSAGE("${ERROR}") +if(NOT "${results}" STREQUAL "1") + message(FATAL_ERROR "Creating chm failed! ${error}") +endif() diff --git a/app/doc/hotbar.but b/app/doc/hotbar.but index fcaddce..eb4ca76 100644 --- a/app/doc/hotbar.but +++ b/app/doc/hotbar.but @@ -8,60 +8,62 @@ \G{png.d/hotbar.png} -The \e{Hot Bar} starts with a flextrack of the current gauge, and then a scrolling list of all the turnouts, sectional track and structures available through the Turnout (\K{cmdTurnout}) and Structure (\K{cmdStructure}) commands. The Description and/or Part Number under each object can be displayed by enabling the \e{Hot Bar Labels} radio button on the Display (\K{cmdDisplay}) dialog. +The \e{Hot Bar} starts with a flex-track of the current gauge, and then a scrolling list of all the turnouts, sectional track and structures available through the Turnout (\K{cmdNewFixedTrack}) and Structure (\K{cmdStructure}) commands. The Description and/or Part Number under each object can be displayed by enabling the \e{Hot Bar Labels} radio button on the Display (\K{cmdDisplay}) dialog. -Only those items taken from files which are in the current scale/gauge are displayed in the HotBar. They are shown in order - A FlexTrack - then the Contents of Files in the File->Parameter Files... List in listed order - and then any Custom objects created in this Layout as listed in the Manage->Custom Defined Parts dialog. +Only those items taken from files which are in the current scale/gauge are displayed in the HotBar. They are shown in order - A Flex-track - then the Contents of Files in the File->Parameter Files... List in listed order - and then any Custom objects created in this Layout as listed in the Manage->Custom Defined Parts dialog. The arrow buttons on either side of the \e{Hot bar} move the list one object to the right or left. Holding down the Shift key will move the list by greater amounts. About eight \c{Shift+Click}s are required to move the list through the entire range of objects. Also, pressing the keys \c{1} through \c{9} and \c{0} will cause the \e{Hot Bar} to jump relative spots on the list. A \c{Right-Click} over the \e{Hot Bar} will display a pop-up menu listing the files with contents on the \e{Hot Bar}. Selecting an item from this list causes the \e{Hot Bar} to jump to the relative spot on the whole list. -Objects on the \e{Hot Bar} are placed on the drawing canvas by first clicking on the object, \e{Dragging} it the Main window, rotating it with \c{Ctrl+Left-Drag} or \c{Right-Drag} positioning it then pressing the \c{Space} key to set it in place. +Objects on the \e{Hot Bar} are placed on the drawing canvas by first selecting an object by \e{Cicking} it on the \e{Hot Bar}. Then \e{Click} and \e{Drag} on the Main window, rotating it with \c{Right-Drag} to position it, and then pressing the \c{Space} key to set it in place. + +For \e{Turnouts}, see below for additional details on the \e{Active EndPoint}. \rule -\S{Flextrack} FlexTrack +\S{Flex-track} \i{Flex-track} -A FlexTrack unit can be placed for convienience on the left-hand side of the HotBar. +A Flex-track unit can be placed for convienience on the left-hand side of the HotBar. This is can be hidden by an option in \K{cmdPref}. It can be recognised because it is the only diagonally facing track element and has a label "FLEX". It is used by \c{Left-Click} selecting it, and \c{Left-Click} clicking on the layout where the first end should be placed, and then \c{Left-Click} for the second end. -If either end is over an unconnected end and \f{Shift} was not held, the flextrack will be connected to the track and the end angle and radius will be set from the track. +If either end is over an unconnected end and \f{Shift} was not held, the flex-track will be connected to the track and the end angle and radius will be set from the track. If an end was not over an unconnected end, it can be manipulated by left dragging out the end angle before releasing. If the second end is not on a track end, differing end angles will produce a smooth curve, if both ends are unconnected, simply \c{Left-Click} without dragging produces a straight track. -Once both ends have been defined, the track can then be manipulated like a \k{chgCornu} Cornu Curved Track, by selecting and moving ends, adding and removing "pins" and altering the end anchor angle and radius if the flextrack is not connected at that end. +Once both ends have been defined, the track can then be manipulated like a \k{chgCornu} Cornu Curved Track, by selecting and moving ends, adding and removing "pins" and altering the end anchor angle and radius if the flex-track is not connected at that end. If the disconnected end is dragged and the button released while over an open end of another track, it will be connected to it in the manner of a Join with a Cornu easement. -A FlexTrack will form a Straight Track if the ends have zero radius and are in a line with opposed end angles. +A Flex-track will form a Straight Track if the ends have zero radius and are in a line with opposed end angles. If the ends are not aligned but the end angles are opposed it will be a simple S-curve. It will be a smooth monotonic curve if the ends are not in a line and the end angle lines and chord form a triangle. Otherwise it will be a complex S-curve. . \rule -\S{hbStructures} Structures +\S{hbStructures} \i{Structures} -\e{Structures} are placed on the layout in the same way as turnouts (\K{hbTurnouts}) except no active endpoint exists and they do not align with existing track. +\e{Structures} are placed on the layout in the same way as turnouts (\K{hbTurnouts}) except no Active EndPoint exists and they do not align with existing track. Refer to \K{cmdStructure} for information pertaining to use of the \e{Structure} dialog. \rule -\S{hbTurnouts} Turnouts +\S{hbTurnouts} \i{Turnouts} -\e{Turnouts} have an active endpoint (\K{generalTerms}) which is the handle used to position the \e{Turnout}. You can change the \e{active endpoint} by a \c{Shift+Left-Click} which causes the next endpoint to become Active. +\e{Turnouts} have an \e{Active EndPoint} (\K{generalTerms}) which is the handle used to position the \e{Turnout}. You can change the \e{Active EndPoint} by a \c{Shift+Left-Click} which causes the next endpoint to become Active. -If you \c{Left+Drag} a turnout onto a track, the active endpoint (\K{generalTerms}) is aligned with the selected track. On flex-track, you can flip the turnout by moving the cursor from one side of the track centerline to the other. On another turnout, the new turnout will be placed at the endpoint closest to the cursor. +If you \c{Left+Drag} a turnout onto a track, the Active EndPoint (\K{generalTerms}) is aligned with the selected track. On flex-track, you can flip the turnout by moving the cursor from one side of the track centerline to the other. On another turnout, the new turnout will be placed at the endpoint closest to the cursor. \e{XTrackCAD} will automatically connect the turnout's endpoints to any other tracks they are aligned with. The number of endpoints that will be connected is displayed on the Status Bar, as well as the Maximum displacement between these endpoints and the tracks they will be connected to. \e{XTrackCAD} will adjust the position of the Turnout to give you the best fit for locating the turnout. You can override this adjustment by holding down the \e{Shift} key while \e{Dragging}. \c{Right+Drag} or \c{Ctrl+Left+Drag} (\K{windowTerms}) can be used to rotate the turnout on the layout. \c{Shift+Right-Click} (\K{cmdAcclKeys}) displays a pop-up menu allowing you to rotate the turnout by various angles. -When you press the \c{Space} key, the turnout is positioned on the layout. Any tracks that are aligned with any of the turnout's endpoints will be connected to the turnout automatically. If you are using the Turnout (\K{cmdTurnout}) command then you can also click the \e{OK} button on the dialog. +When you press the \c{Space} key, the turnout is positioned on the layout. Any tracks that are aligned with any of the turnout's endpoints will be connected to the turnout automatically. If you are using the Turnout (\K{cmdNewFixedTrack}) command then you can also click the \e{OK} button on the dialog. If you choose another turnout or change commands after beginning to place a turnout on the layout, the turnout will be created as if it is attached to another track. Otherwise it will be removed. If the Drawing Scale is smaller or equal to the Label Scale (\K{cmdDisplay}) then Turnouts will be labeled with their description when drawn. The individual labels can be can be turned off by the Move Description(\K{cmdMoveLabel}) command, or all Turnout labels can be disabled by using the Display (\K{cmdDisplay}) dialog. As well, the length of any connected Flex-track will be indicated at each endpoint. -Refer to \K{cmdTurnout} for information pertaining to use of the \e{Turnout} dialog. +Refer to \K{cmdNewFixedTrack} for information pertaining to use of the \e{Turnout} dialog. \rule diff --git a/app/doc/intro.but.in b/app/doc/intro.but.in index 1a423f0..2a64c51 100644 --- a/app/doc/intro.but.in +++ b/app/doc/intro.but.in @@ -6,7 +6,7 @@ \# Identify XTrackCAD Version, Microsoft Windows software installation package name and Copyright information -\define{XTCVer} Version @XTRKCAD_VERSION@ +\define{XTCVer} Version @XTRKCAD_VERSION@ \define{XTCWinPack} xtrkcad-setup-@XTRKCAD_VERSION@.exe @@ -27,14 +27,10 @@ Copyright 2020, Martin Fischer, Adam Richards and Dave Bullis \IM{Easements}{Easements and Sectional Track} Easements -\IM{Export}{Export to Bitmap}{Export to DXF} Export - \IM{Window Terms}{XTrackCAD Terms} Glossary \IM{Install directory}{Linux Installation}{Microsoft Windows Installation} Installation -\IM{Copying and Distribution}{GNU General Public License} License - \IM{Add Menu}{File Menu}{Edit Menu}{View Menu}{Change Menu}{Draw Menu}{Manage Menu}{Options Menu} Menus \IM{Entering Values}{Keyboard Shortcuts}{Main Window Overview}{Map Window}{Mouse Actions}{Shortcut Keys}{Typographic Conventions} Navigation @@ -43,8 +39,6 @@ Copyright 2020, Martin Fischer, Adam Richards and Dave Bullis \IM{Additional Shortcut Keys}{Hot Bar}{Keyboard Shortcuts}{Main Drawing Canvas}{Mouse Actions}{Shortcut Keys} Shortcut Keys -\IM{Created by Turnout Command}{Easements and Sectional Track} Sectional Track - \# >>>>>>>>>> Manual Begin's Here <<<<<<<<<< \title \e{XTrackCAD} User's Manual @@ -61,7 +55,7 @@ Copyright 2020, Martin Fischer, Adam Richards and Dave Bullis \cfg{html-local-head}{<meta name="AppleTitle" content="org.xtrkcad.help" />} -\e{XTrackCAD} is a CAD (computer-aided design) program for designing Model Railroad layouts. \e{XTrackCAD} supports any scale, has libraries of popular brands of turnouts and sectional track (plus you add your own easily), can automatically use spiral transition curves when joining track and has extensive on-line help and demonstrations. \e{XTrackCAD} lets you manipulate track much like you would with actual flex-track to modify, extend and join tracks and turnouts. Additional features include tunnels, 'post-it' notes, on-screen ruler, parts list, 99 drawing layers, undo/redo commands, bench-work, 'Print to Bitmap', elevations, train simulation and car inventory. +\e{XTrackCAD} is a CAD (computer-aided design) program for designing Model Railroad layouts. \e{XTrackCAD} supports any scale, has libraries of popular brands of turnouts and sectional track (plus you add your own easily), can automatically use spiral transition curves when joining track and has extensive on-line help and demonstrations. \e{XTrackCAD} lets you manipulate track much like you would with actual flex-track to modify, extend and join tracks and turnouts. Additional features include tunnels, 'post-it' notes, on-screen ruler, parts list, 99 drawing layers, undo/redo commands, bench-work, 'Print to Bitmap', elevations, train simulation and car inventory. Using it, you can @@ -89,7 +83,7 @@ Using it, you can \u000 -\b Trace tracks and other objects over a background image of a real-world location map, a scanned trackplan, or other image. +\b Trace tracks and other objects over a background image of a real-world location map, a scanned trackplan, or other image. \u000 @@ -110,17 +104,17 @@ Be sure to visit the project web page for latest news and updates: \W{http://www \f{Easy to use} - \e{XTrackCAD} was designed to operate in a similar way to pencil and paper: You can draw tracks by dragging the mouse, you select and place turnout "templates" anywhere on existing tracks, and you can use fixed radii for initial design. - -But extra capabilities have been added that give more power by using FlexTracks (Cornu) you have tracks that automatically redraw as you drag turnouts around, creating smooth curves, you can zoom in and out, and of course, undo and deleting tracks are easier! + \e{XTrackCAD} was designed to operate in a similar way to pencil and paper: You can draw tracks by dragging the mouse, you select and place turnout "templates" anywhere on existing tracks, and you can use fixed radii for initial design. -You don't have to be an expert CAD user to make the most of \e{XTrackCAD} but the program will ensure that dimensions, radii and angles are accurate. +But extra capabilities have been added that give more power by using Flex-tracks (Cornu) you have tracks that automatically redraw as you drag turnouts around, creating smooth curves, you can zoom in and out, and of course, undo and deleting tracks are easier! + +You don't have to be an expert CAD user to make the most of \e{XTrackCAD} but the program will ensure that dimensions, radii and angles are accurate. You don't have to specify line lengths or angles and just draw. But if you want to be more precise, you can enter precise dimensions both in real-world and scale sizes. -\e{XTrackCAD} is a specialized CAD for railway modelling, it deals with tracks as tracks, not as line segments. Tracks are connected correctly to each other and with endpoints of turnouts and other components. +\e{XTrackCAD} is a specialized CAD for railway modelling, it deals with tracks as tracks, not as line segments. Tracks are connected correctly to each other and with endpoints of turnouts and other components. -As you zoom in, the two rails are drawn and then ties are added. +As you zoom in, the two rails are drawn and then ties are added. \f{Free} @@ -132,33 +126,35 @@ On-line demonstrations show the actual operation of many of the program's featur \f{Packed with features} -\e{XTrackCAD} is designed from the ground up to be a complete tool for many aspects of Model Railroad layout design. +\e{XTrackCAD} is designed from the ground up to be a complete tool for many aspects of Model Railroad layout design. \dt \e{Active UI Prompting} \dd As the mouse moves over the layout objects, a set of different anchors are shown to indicate what is possible in each command with each modifier key if clicked or double clicked at that location. +\u000 + \dt \e{Train Simulation and Car Inventory} \dd Any number of Cars and Locomotives can be placed on your layout to check clearances, siding capacities and track layout. Trains can be animated to simulate operations and switching on your layout. \u000 -\dd The Car Inventory dialog records your cars and locomotives and these can be exported and imported from spreadsheets. +\dd The Car Inventory dialog records your cars and locomotives and these can be exported and imported from spreadsheets. \u000 \dt \e{Track Manipulation} -\dd Track segments can be lengthened or shortened by simple click and drag. Tangents to a curve are created by dragging away from the curve. Tracks are extended by dragging from an Endpoint, creating new straight or curved segments. New tracks can be snapped into place or precisely placed and then Joined. +\dd Track segments can be lengthened or shortened by simple click and drag. Tangents to a curve are created by dragging away from the curve. Tracks are extended by dragging from an Endpoint, creating new straight or curved segments. New tracks can be snapped into place or precisely placed and then Joined. \u000 -\dd Track circles are especially handy for determining overall designs and seeing what will fit in a given area. +\dd Track circles are especially handy for determining overall designs and seeing what will fit in a given area. \u000 -\dd The Cornu flextrack features create dynamically variable tracks that optimise the curvature of tracks to ensure a protypical appearance. They alter as the other tracks are moved just as flextrack will in the 12 inches to the foot world! +\dd The Cornu flex-track features create dynamically variable tracks that optimise the curvature of tracks to ensure a protypical appearance. They alter as the other tracks are moved just as flex-track will in the 12 inches to the foot world! \u000 @@ -166,38 +162,40 @@ On-line demonstrations show the actual operation of many of the program's featur \u000 -\dd The Join command links any two tracks (Straights, Curves, Turnouts or Turntables) with accurate aligned connecting track segments which can be easements including Cornu easements. The connected tracks are trimmed or extended as required. +\dd The Join command links any two tracks (Straights, Curves, Turnouts or Turntables) with accurate aligned connecting track segments which can be easements including Cornu easements. The connected tracks are trimmed or extended as required. \u000 -\dd The Helix Track command computes the number of turns, radius, grade and vertical separation based on your criteria. +\dd The Helix Track command computes the number of turns, radius, grade and vertical separation based on your criteria. \u000 \dd Turntables can be constructed with any radius and can either have fixed or dynamic bay tracks +\u000 + \dt \e{Turnout Select and Placement} -\dd The Turnout Hot Bar contains a scrolling list of Turnouts, Sectional Tracks and Structures available in the current Scale. Simply click on one and click again drop it onto the layout. +\dd The Turnout Hot Bar contains a scrolling list of Turnouts, Sectional Tracks and Structures available in the current Scale. Simply click on one and click again drop it onto the layout. \u000 -\dd As Turnouts are dragged over existing tracks they are automatically aligned. \e{XTrackCAD} searches for any other tracks that align with each of the Turnout's Endpoints, and shows you the number of connections that will be made and the maximum offset as you position the Turnout. -Just adjust the Turnout's position to minimize the offset to ensure the best fit. +\dd As Turnouts are dragged over existing tracks they are automatically aligned. \e{XTrackCAD} searches for any other tracks that align with each of the Turnout's Endpoints, and shows you the number of connections that will be made and the maximum offset as you position the Turnout. +Just adjust the Turnout's position to minimize the offset to ensure the best fit. \u000 -\dd When a turnout is placed, each Endpoint is examined to see if it aligned to an existing track. If so, the track is split to create a perfect connection to the turnout. Placing Turnouts is a 'snap'. +\dd When a turnout is placed, each Endpoint is examined to see if it aligned to an existing track. If so, the track is split to create a perfect connection to the turnout. Placing Turnouts is a 'snap'. \u000 \dt \e{Layers} -\dd Layers are an important feature for manageing the design for layouts of any complexity. Use one layer for the main-line and others for staging tracks, Bench-work or scenery. Multilevel designs can have groups of layers for each level. +\dd Layers are an important feature for manageing the design for layouts of any complexity. Use one layer for the main-line and others for staging tracks, Bench-work or scenery. Multilevel designs can have groups of layers for each level. \u000 -\dd \e{XTrackCAD} allows up to 99 layers layers can have their own button to control visibility. Each layer can have a name which is displayed as the balloon help for the layer button. +\dd \e{XTrackCAD} allows up to 99 layers layers can have their own button to control visibility. Each layer can have a name which is displayed as the balloon help for the layer button. \u000 @@ -205,13 +203,13 @@ Just adjust the Turnout's position to minimize the offset to ensure the best fit \u000 -\dd Tracks and other objects can be colored according to which layer they are in. Also, each layer can be frozen to prevent accidental changes to parts of the layout that are finalized. +\dd Tracks and other objects can be colored according to which layer they are in. Also, each layer can be frozen to prevent accidental changes to parts of the layout that are finalized. \u000 \dt \e{Elevations and Profile} -\dd Elevations are one of the most powerful features of \e{XTrackCAD} they are dynamically recalulated as the layout changes. +\dd Elevations are one of the most powerful features of \e{XTrackCAD} they are dynamically recalulated as the layout changes. \u000 @@ -219,21 +217,21 @@ Just adjust the Turnout's position to minimize the offset to ensure the best fit \u000 -\dd \e{XTrackCAD} lets you define the elevation of any Endpoint on the layout. You can also have \e{XTrackCAD} automatically compute the elevation and grade between defined elevation points. You can define the elevation at the bottom and top of a sloped track, then have \e{XTrackCAD} compute the elevation at each riser position between. +\dd \e{XTrackCAD} lets you define the elevation of any Endpoint on the layout. You can also have \e{XTrackCAD} automatically compute the elevation and grade between defined elevation points. You can define the elevation at the bottom and top of a sloped track, then have \e{XTrackCAD} compute the elevation at each riser position between. \u000 -\dd Once you have defined a few elevations, you can display the Elevation Profile for the layout along a path of connected track segments. The Profile display shows the length of the track, the elevation of each defined elevation point and the grades between them. You can even adjust the elevations directly on the Profile display. +\dd Once you have defined a few elevations, you can display the Elevation Profile for the layout along a path of connected track segments. The Profile display shows the length of the track, the elevation of each defined elevation point and the grades between them. You can even adjust the elevations directly on the Profile display. \u000 \dt \e{Easements (Cornu Transition Curves)} -\dd Easements are special sections of gradually curving track used to connect straight and curved tracks (or two curved tracks). Easements reduce the effects of sudden changes in track curves which can cause derailments. They also look great! +\dd Easements are special sections of gradually curving track used to connect straight and curved tracks (or two curved tracks). Easements reduce the effects of sudden changes in track curves which can cause derailments. They also look great! \u000 -\dd \e{XTrackCAD} can use Easements anytime the radius of the track changes. The Modify and Join commands will automatically insert Easement Track segments whenever needed. Each Easement is computed based on the radius of the neighboring tracks. You don't even have to think about it! +\dd \e{XTrackCAD} can use Easements anytime the radius of the track changes. The Modify and Join commands will automatically insert Easement Track segments whenever needed. Each Easement is computed based on the radius of the neighboring tracks. You don't even have to think about it! \u000 @@ -257,51 +255,51 @@ Just adjust the Turnout's position to minimize the offset to ensure the best fit \u000 -\dd The Print command lets you scale the printout from a one page overall view (with the handy Snap-Shot button) right up to full size 1:1. +\dd The Print command lets you scale the printout from a one page overall view (with the handy Snap-Shot button) right up to full size 1:1. \u000 -\dd Multiple page printouts are easy to do. A gird representing each page is drawn over the layout and you can click on the pages you want to print. The gird can be moved and rotated to any position so the orientation of the printout matches your layout. Pages can be printed in Portrait or Landscape format. +\dd Multiple page printouts are easy to do. A gird representing each page is drawn over the layout and you can click on the pages you want to print. The gird can be moved and rotated to any position so the orientation of the printout matches your layout. Pages can be printed in Portrait or Landscape format. \u000 -\dd At 1:1, registration marks can be printed every 3" (or 10cm) to help align different sets of printouts. Also, the roadbed outline can be drawn at a user-specified width to assist cutting the roadbed from sheet material. +\dd At 1:1, registration marks can be printed every 3" (or 10cm) to help align different sets of printouts. Also, the roadbed outline can be drawn at a user-specified width to assist cutting the roadbed from sheet material. \u000 \dt \e{Turnout and Structure Creation} -\dd \e{XTrackCAD} comes with Turnout, Sectional Track and Structure Parameter Files for many brands of tracks and accessories. However, your brand may not supplied. The Turnout Designer dialogs and the Group command make it easy to add your own custom definitions. +\dd \e{XTrackCAD} comes with Turnout, Sectional Track and Structure Parameter Files for many brands of tracks and accessories. However, your brand may not supplied. The Turnout Designer dialogs and the Group command make it easy to add your own custom definitions. \u000 -\dd The Turnout Editor has separate screens for designing Turnouts (Regular, Curved, Wye and 3-way), Crossings, Slip-switch, Crossovers and Sectional Track. In each dialog a few measurements are required to create a new definition. Full size printouts can be made directly from the dialog to check your design. +\dd The Turnout Editor has separate screens for designing Turnouts (Regular, Curved, Wye and 3-way), Crossings, Slip-switch, Crossovers and Sectional Track. In each dialog a few measurements are required to create a new definition. Full size printouts can be made directly from the dialog to check your design. \u000 -\dd The Group command can create Structure definitions from selected tracks, lines and shapes. You can make structures as simple as a rectangle or highly detailed. You can also modify existing designs to add details or make adjustments. +\dd The Group command can create Structure definitions from selected tracks, lines and shapes. You can make structures as simple as a rectangle or highly detailed. You can also modify existing designs to add details or make adjustments. \u000 \dt \e{Lines, Shapes, Table Edges, Text and Notes} -\dd Layout designs are more than track! +\dd Layout designs are more than track! \u000 -\dd The \e{XTrackCAD} Draw command is used to draw lines (straight, curved and circles) and shapes (filled boxes, circles, polylines and polygons). These can be different colors and lines can have different widths. The Polylines and Polygons can have curved sides. These are useful for drawing scenic features (rivers, bridges, mountains). +\dd The \e{XTrackCAD} Draw command is used to draw lines (straight, curved and circles) and shapes (filled boxes, circles, polylines and polygons). These can be different colors and lines can have different widths. The Polylines and Polygons can have curved sides. These are useful for drawing scenic features (rivers, bridges, mountains). \u000 -\dd You can add Bench-work and dimension lines too. +\dd You can add Bench-work and dimension lines too. \u000 -\dd Special types of lines are drawn by the Table Edge command are used to represent the boundary at the edge of the layout. +\dd Special types of lines are drawn by the Table Edge command are used to represent the boundary at the edge of the layout. \u000 -\dd Text can be added to the layout. +\dd Text can be added to the layout. \u000 @@ -311,21 +309,21 @@ Just adjust the Turnout's position to minimize the offset to ensure the best fit \dt \e{Parts and Price Lists} -\dd The Parts List command generates a list of the number of the different types of Turnouts, Sectional Track and Structures selected on the layout. You can select everything or just the areas you are working on. As well, the total length of flex-track (for each track scale/gauge used on the layout) is listed. +\dd The Parts List command generates a list of the number of the different types of Turnouts, Sectional Track and Structures selected on the layout. You can select everything or just the areas you are working on. As well, the total length of flex-track (for each track scale/gauge used on the layout) is listed. \u000 -\dd You can enter the price of each type of Turnout, Sectional Track and Structure, plus the length and price of flex-track. \e{XTrackCAD} will compute the price of each types and the grand total. The total number of flex-track sections is also listed. +\dd You can enter the price of each type of Turnout, Sectional Track and Structure, plus the length and price of flex-track. \e{XTrackCAD} will compute the price of each types and the grand total. The total number of flex-track sections is also listed. \u000 \dt \e{Support for Sectional Track} -\dd Numerous Sectional Track Parameter Files are included with \e{XTrackCAD} (Atlas, Marklin, Peco, ...). The Hot Bar allows easy selection. +\dd Numerous Sectional Track Parameter Files are included with \e{XTrackCAD} (Atlas, Marklin, Peco, ...). The Hot Bar allows easy selection. \u000 -\dd The automatic alignment feature of Turnout and Sectional Track placements makes track pieces just 'snap' together. +\dd The automatic alignment feature of Turnout and Sectional Track placements makes track pieces just 'snap' together. \u000 @@ -469,9 +467,9 @@ Refer to \K{keyFeatures} and \K{addFeatures} for a listing of \e{XTrackCAD} feat \H{addFeatures} Additional \e{XTrackCAD} Features -\e{XTrackCAD} has many other carefully selected features: +\e{XTrackCAD} has many other carefully selected features: -\b Sections of track can be hidden, which can be drawn as dashed lines, or completely hidden. A Tunnel Portal is drawn when a hidden track connects with normal track. +\b Sections of track can be hidden, which can be drawn as dashed lines, or completely hidden. A Tunnel Portal is drawn when a hidden track connects with normal track. \u000 @@ -519,7 +517,7 @@ Refer to \K{keyFeatures} and \K{addFeatures} for a listing of \e{XTrackCAD} feat \u000 -\b You can rescale and flip objects, trim turnouts and create block gaps. +\b You can rescale and flip objects, trim turnouts and create block gaps. \u000 @@ -586,7 +584,7 @@ Throughout this manual the following typographic conventions are used to make fi \lcont{\u000} -\n A program folder named \c{XTrkCad4} will be created during the installation process. The folder contains the program, documentation, parameter and example files. +\n A program folder named \c{XTrkCad} will be created during the installation process. The folder contains the program, documentation, parameter and example files. \rule @@ -594,8 +592,8 @@ Throughout this manual the following typographic conventions are used to make fi \e{XTrackCAD} for OSX is shipped as a package containing an application. -\n Start the installation by opening the package and dragging the contained application into the \e{Applications} folder using the shortcut in the package. -The application includes the program, documentation, parameter and example files within it. +\n Start the installation by opening the package and dragging the contained application into the \e{Applications} folder using the shortcut in the package. +The application includes the program, documentation, parameter and example files within it. \lcont{\u000} @@ -603,7 +601,7 @@ The application includes the program, documentation, parameter and example files \lcont{\u000} -\n \i{OSX Run Security} When the application is first run, it will need to be authorized by OSX. There will be a OSX prompt that asks if it should be opened. And then it will still fail to run. +\n \i{OSX Run Security} When the application is first run, it will need to be authorized by OSX. There will be a OSX prompt that asks if it should be opened. And then it will still fail to run. After opening it for the first time, go to \e{System Preferences>Security & Privacy} and you will see that the app is named as having been blocked. Hit the \e{Run Anyway} button and the program should start. This sequence may be necessary after each OS upgrade. @@ -613,17 +611,17 @@ This sequence may be necessary after each OS upgrade. \S{LinuxInstall} \i{Linux Installation} -\e{XTrackCAD} for LINUX is shipped as a self-extracting archive (executable). - +\e{XTrackCAD} for LINUX is shipped as a self-extracting archive (executable). + \n Installing from the self-extracting archive. \lcont{ -\dd After downloading open a command line then +\dd After downloading open a command line then -\dd \c{./\XTCStgzPack --prefix=/usr/local --exclude-subdir} +\dd \c{./\XTCStgzPack --prefix=/usr/local --exclude-subdir} -\dd This will install the executable in /usr/local/bin. A directory named \c{xtrkcad} will be created in +\dd This will install the executable in /usr/local/bin. A directory named \c{xtrkcad} will be created in /usr/local/share and all files will be unpacked into it. } @@ -636,7 +634,7 @@ If you install \e{XTrackCAD} into another directory, set the \c{XTRKCADLIB} envi The \e{XTrackCAD} executable is named xtrkcad.exe on Windows and xtrkcad on Linux and OSX. -It is usually started by clicking on its icon, or right-click and \f{Open} in OSX Catalina, but there are command line options as well. +It is usually started by clicking on its icon, or right-click and \f{Open} in OSX Catalina, but there are command line options as well. \f{Command Line} @@ -657,19 +655,19 @@ On Linux: \dt \c{c config} -\dd configuration to use. This allows you to have several distinct configurations (eg. +\dd configuration to use. This allows you to have several distinct configurations (eg. parameter files, display options). \u000 \dt \c{layoutfile} -\dd filename for the layout to load. +\dd filename for the layout to load. This parameter takes precedence over the option to resume with the last layout (\K{cmdPref}). \f{Debugging Parameters} -The following parameters are for debugging purposes and are mainly of interest to the +The following parameters are for debugging purposes and are mainly of interest to the developers. \dt \c{v} @@ -681,7 +679,7 @@ developers. \dt \c{d logcontrol} \dd specifies the amount of logging. The argument logcontrol has the format \c{logmodule[=level]}. -logmodule defines the functionality that should be logged, the optional level specifies the loglevel. Zero means no logging. +logmodule defines the functionality that should be logged, the optional level specifies the loglevel. Zero means no logging. Defaults are no modules are logged and loglevel is 1 if omitted from logonctrol parameter. \u000 @@ -690,6 +688,21 @@ Defaults are no modules are logged and loglevel is 1 if omitted from logonctrol \dd set logfile, only needed in conjunction with the debug option. +\u000 + +\dt \c{T} + +\dd Runs all Regression tests (Demos) and exits with 0 if all are successful or with 1 if there any failures. +Regression progress and failures are logged to stdout (Linux and Mac OSX) or xtclog.txt (Windows). + +\u000 + +\dt \c{V} + +\dd Display the xtrkcad version and exit(0). + +\u000 + \H{introQT} Quick Tour \G{png.d/main.png} @@ -739,7 +752,7 @@ Under the Tool Bar is the Hot Bar. This contains defined track and drawing objec The main part of the window is the Drawing Area, this is where the Layout is shown in 2D. The view can be zoomed or panned. The \f{Pan-Zoom} command whise symbol is the crossed arrows allows easiest control, but in \f{Select} command you can pan with the arrow keys and zoom with the trackpad or mousewheel or \f{Ctrl}+"+" or "-" can affect the zoom level. -\rule +\rule At the bottom on the screen are two more areas. The Status Bar contains messages about commands as they are being used, and the Info Bar shows the zoom level and the position of the cursor. @@ -768,7 +781,7 @@ This section lists some things that can improve the performance of \e{XTrackCAD} \H{directories} Files and Directories -Information within this section of the manual identifies installation directory names, file names and directory and file locations. +Information within this section of the manual identifies installation directory names, file names and directory and file locations. \rule @@ -782,15 +795,15 @@ Information within this section of the manual identifies installation directory \b The \e{XTrackCAD Working} directory, which contains configuration and Check Point files. -On MS Windows, the \e{Install} directory is set when you install \e{XTrackCAD}. All data files (parameters, -demos, examples) can be found in the \c{share/xtrkcad} subdirectory underneath the \e{Install} directory. +On MS Windows, the \e{Install} directory is set when you install \e{XTrackCAD}. All data files (parameters, +demos, examples) can be found in the \c{share/xtrkcad} subdirectory underneath the \e{Install} directory. The \e{Working} directory is in your personal profile. On Linux, the \e{Install} directory is usually \c{/usr/local/lib/xtrkcad/}, but you can change this by defining the \c{XTRKCADLIB} environment variable before starting \e{XTrackCAD}. The working directory is \c{\{HOME\}/.xtrkcad/}. On Mac OSX, the \e{Install} directory is the application package, usually located in the \c{/Applications} directory. All the included parameters, demos and examples can be found inside the package under the \c{/Applications/xtrkcad/Contents/Resources/xtrkcad} directory. -The \e{Working} directory is created as \c{.xtrkcad} - a hidden directory - under the active user's directory in \c{/Users} +The \e{Working} directory is created as \c{.xtrkcad} - a hidden directory - under the active user's directory in \c{/Users} Layout files (\c{*.xtc}) and export (\K{cmdExport}) files (\c{*.xti}) can be saved anywhere you wish, as specified in the \f{Save File} and \f{Open File} dialogs. @@ -863,7 +876,7 @@ On MS-Windows only, you can also use the \f{Uninstall} icon in the \e{XTrackCAD} \H{bugs_enhancements} Bugs and Enhancements -This section of the manual describes how and where to report a bug or seek an enhancement. +This section of the manual describes how and where to report a bug or seek an enhancement. \rule @@ -890,7 +903,7 @@ If you encounter an unreported bug please submit detail regarding such to the \f \u000 -\dd The error can be replicated by opening the file named cascade.xtc. Set the magnification at 4:1. Attempting to move the text label named "Granville Island" located at the approximate grid coordinates of x=8", y=4' 5". Selecting the label causes the error to occur. +\dd The error can be replicated by opening the file named cascade.xtc. Set the magnification at 4:1. Attempting to move the text label named "Granville Island" located at the approximate grid coordinates of x=8", y=4' 5". Selecting the label causes the error to occur. \u000 @@ -902,7 +915,7 @@ If you encounter an unreported bug please submit detail regarding such to the \f \f{Please be brief, but don't leave any important details out.} This is a fine line to walk. But there are some general guidelines: -Remember the three basics: what you were doing, what you expected to happen, and what happened. +Remember the three basics: what you were doing, what you expected to happen, and what happened. If you can recreate the problem the \f{Macro>Record} command can be used to record what happened. Try to isolate the problem by creating a minimal layout and recording as few commands as possible. diff --git a/app/doc/managem.but b/app/doc/managem.but index 7996ef1..080a81e 100644 --- a/app/doc/managem.but +++ b/app/doc/managem.but @@ -55,7 +55,7 @@ The \f{Manage Menu} shows commands affecting the \f{Main Canvas} (\K{mainW}). \rule -\S{cmdCarinv} Car Inventory +\S{cmdCarinv} \i{Car Inventory} This dialog is used to manage your list of cars and locomotives. @@ -65,13 +65,16 @@ The main part of this dialog contains a detailed list of each car and locomotive Cars are placed on the layout by using the \f{Train Simulation} (\K{cmdTrain}) command. -The \f{Find} button will center the \f{Main Window} (\K{mainW}) on the selected car. This button is only enabled for cars which are on the Layout (indicated by \f{Layout} in the Location column). If the car on a track that is hidden and \f{Trains on Hidden Track} (\K{cmdDisplay}) is set to \f{Hide}, then the car (and any attached cars) will be made visible. +The \f{Find} button will center the \f{Main Window} (\K{mainW}) on the selected car. This button is only enabled for cars which are on the Layout (indicated by co-ordinates in the Location column). If the car on a track that is hidden and \f{Trains on Hidden Track} (\K{cmdDisplay}) is set to \f{Hide}, then the car (and any attached cars) will be made visible. The \f{Edit} button invokes the \f{Car} dialog (\K{cmdCarpart}) to modify the selected car. This button is disabled if more than one (or no) car is selected or if the selected car is on the Layout. The \f{Add} button is to add a new Car. Refer to \K{faqsPrototype} if an error occurs when attempting to add inventory to this list. -The \f{Delete} button removes the selected cars from your inventory. This button is disabled if any of the selected cars are on the layout. +The \f{Delete|Shelve} button serves two functions: +If all selected cars are on the layout then this button shows \f{Shelve} and it moves them from the layout and returns them to the \f{Shelf}. +If all selected cars are on the \f{Shelf} then this button shows \f{Delete} and they will be deleted from the Inventory. +Otherwise, the button is blank and disabled. The \f{Import} and \f{Export} buttons read and write a \e{Comma-Separated-Value (CSV)} file. This file format can be read and written by many applications. It can be used to transfer car inventory data between different applications. This file contains the following columns (the first four are required when Importing): @@ -117,7 +120,17 @@ The \f{Import} and \f{Export} buttons read and write a \e{Comma-Separated-Value \u000 -\dd \e{Options} - 2 (Locomotives), 4 (Body Mounted Couplers) +\dd \e{Options} - bit map of + +\lcont{ + +\b 0x0001 - Body Mounted Couplers + +\b 0x0002 - Locomotive + +\b Other bits can be ignored + +} \u000 @@ -125,11 +138,11 @@ The \f{Import} and \f{Export} buttons read and write a \e{Comma-Separated-Value \u000 -\dd \e{Color} - encoded as (Red * 65535 + Green * 256 + Blue) +\dd \e{Color} - encoded as (Red * 65536 + Green * 256 + Blue) \u000 -\dd \e{PurchPrice}, \e{CurrPrice}, \e{PurchDate} and \e{ServiceDate} - numeric values +\dd \e{PurchPrice}, \e{CurrPrice}, \e{PurchDate} and \e{ServiceDate} - numeric values - dates are in the form yyyymmdd, where yyyy is the year, mm the month, dd the day \u000 @@ -159,7 +172,7 @@ The \f{List} button creates a text file listing your inventory. \rule -\S2{cmdCarpart} Car Item Dialog +\S2{cmdCarpart} \i{Car Item Dialog} This dialog is invoked from the \f{Car Inventory} (\K{cmdCarinv}) and the \f{Custom Management} (\K{cmdCustmgm}) dialogs. @@ -207,7 +220,7 @@ The dialog contains: \rule -\S2{carpart} \f{Car Part Dialog} +\S2{carpart} \i{Car Part Dialog} This dialog is similar the the \f{Car Item} dialog except that the \f{Car Item Information} section is not displayed. The \f{Manufacturer} Drop Down List is editable so you can enter a new manufacturer, and you must enter a \f{Part Number}. If you are adding a new car part, the \f{Part Number} field will be incremented (if it is a numeric value) so you can enter a number of car parts. @@ -215,7 +228,7 @@ This dialog is similar the the \f{Car Item} dialog except that the \f{Car Item I The middle section contains: -\dd The \f{Road}, \f{Reporting Mark}, \f{Number} and \f{Color}. You can choose a \f{Road name} from the list of known road names or enter a new value. If known, the \e{reporting mark} (road name abbreviation) is filled in. +\dd The \f{Road}, \f{Reporting Mark}, \f{Number} and \f{Color}. You can choose a \f{Road name} from the list of known road names or enter a new value. If known, the \e{reporting mark} (road name abbreviation) is filled in. These values control what label content is shown for Cars. If a reporting number is present the rep mark and the rep number will be used if the Cars Label Option is on in \K{cmdDisplay} \u000 @@ -254,7 +267,7 @@ See NMRA TN-7 Curved Track Centerline and Obstacle Clearance Calculation Methodo \rule -\S2{carprototype} \f{Car Prototype Dialog} +\S2{carprototype} \i{Car Prototype Dialog} This dialog is used to create or edit prototype definitions. @@ -278,7 +291,7 @@ Unlike the other dialogs, dimensions in this dialog are in prototype units. Whe \rule -\S{cmdCustmgm} Custom Management +\S{cmdCustmgm} \i{Custom Management} The \f{Custom Management} dialog allows you change the properties of turnouts, sectional track, structures, car parts and prototypes you have designed with the \f{Turnout Designer} (\K{cmdTurnoutNew}), \f{Group} (\K{cmdGroup}) or \f{Car} (\K{cmdCarpart}) commands. You can also move selected objects to a \f{Parameter File} (\K{cmdPrmfile}). @@ -304,7 +317,7 @@ The \f{New} buttons invokes the Car (\K{cmdCarpart}) dialog to create a new \f{C \rule -\S{cmdContmgm} Layout Control Elements Dialog +\S{cmdContmgm} \i{Layout Control Elements Dialog} This dialog is used to manage layout control elements (blocks, switchmotors, and signals). @@ -334,7 +347,7 @@ either from their Hotbar menus or from the Add menu. The \f{Edit} button allows for editing a control element. And the \f{Delete} button deletes the selected element(s). -\S{cmdGroup} Group Dialog +\S{cmdGroup} \i{Group Dialog} The \f{Group} command combines the selected (\K{cmdSelect}) Lines and Shapes (\K{cmdDraw}) to create structures (\K{cmdHotBar}). You can give the structure (\K{cmdHotBar}) a title consisting of Manufacturer, Description and Part Number on the \f{Group} dialog. @@ -342,31 +355,64 @@ The \f{Group} command combines the selected (\K{cmdSelect}) Lines and Shapes (\K The title will be pre-populated with the title of the last \f{Structure} you \f{ungrouped} (\K{manageM}). -You can include \f{Turnouts}, \f{Sectional}, \f{Straight} or \f{Curved} tracks in the selected objects which allows you to add cosmetic details to a \f{Turnout} definitions, or create a new \f{Turnout} definition. This can also be used to if there are fixed track locations on a structure, like on an engine shed. +You can include \f{Turnouts}, \f{Sectional}, \f{Straight} or \f{Curved} tracks in the selected objects which allows you to add cosmetic details to a \f{Turnout} definitions, or create a new \f{Turnout} definition. This can also be used to if there are fixed-track locations on a structure, like on an engine shed. + +\f{Group} is intended to operate on simple groups of track segments. If you intend to group a large number of track segments, you should consider using \f{Import Module} (see \K{cmdLayer}), To modify a \f{Structure} or \f{Turnout} definition, first place the object on the layout, select and then \f{Ungroup} the object. Now the parts of the object can be edited using the \f{Modify} (\K{cmdModify}), \f{Draw} (\K{cmdDraw}) or other commands. Once completed, select the object parts and use the \f{Group} command to update the definition (or create a new one by changing the title). -The \f{Group} dialog shows the Manufacturer, Description and part number (Title) of the new definition. Initial values are based on selected turnouts and structures or on the last \f{Ungroup}ed object (\K{cmdUngroup}). The dialog also contains a toggle button (\f{Replace with new group}?), which is used if you want to replace the selected objects with the new definition. All fields listed in this dialog window must contain data. +The \f{Group} dialog shows the Manufacturer, Description and part number (Title) of the new definition. Initial values are based on selected turnouts and structures or on the last \f{Ungroup}ed object (\K{cmdUngroup}). +The \f{Turntable/TransferTable/DblSlipSwitch}? toggle button controls whether non-conflicting \f{Paths} should be combined or keep separate, see \f{Paths} below. +The \f{Replace with new group}? toggle button is used if you want to replace the selected objects with the new definition. +All fields listed in this dialog window must contain data. The definition data will be added to the \c{xtrkcad.cus} (\K{directories}) file for later use. Please consider contributing this information for others to use. If you modify a definition from a \e{XTrackCAD} Library parameter file, the new definition will replace the existing definition on the \f{Hot Bar} (\K{cmdHotBar}), otherwise it will be added to the end of the \f{Hot Bar}. You can use the \f{Custom Management} (\K{cmdCustmgm}) dialog to change the title or delete custom definitions. -\f{Note:} There is a limit of 128 track segments in a group. +\f{Note:} +The selected tracks are decomposed into segments, which are simple tracks and drawing object (lines, curves, polygons ... ). +Any track segments must appear in the first 127 segments. +This implies a limit of 127 track segments. + +\dd You can re-order the segment list by + +\lcont{ + +\b Ungroup the selected tracks + +\b Unselect all, and select the tracks you want to group + +\b \f{Move selected objects to bottom} + +\b Add the non-tracks object to the selected track segments + +\b Retry the \f{Group} command + +} + +\f{Paths} define which segments are followed by a train in Train mode. +Normally, if two paths follow paths of separate segments, then the paths are combined. +For example a simple turnout would have two paths, but since the paths share some common segments, the paths are not combined. +A Crossing has two paths but since they don't have any segments in common, the two paths are combined into one. +A Turntable can have many distinct paths but only one would be valid at any time. In this case we don't want to combine paths and the toggle would be checked. \rule -\S{cmdLayer} Layers Dialog +\S{cmdLayer} \i{Layers Dialog} -Each object is contained in a layer - which is a custom group of objects that do not have a particular visual order, but can be treated as a set for certain commands. Objects which are created independently of other objects (such as straight tracks (\K{cmdStraight}) or text (\K{cmdText})) are created in the current layer. Objects which are associated with other objects (such as tracks created by the \f{Modify} (\K{cmdModify}) or \f{Join} (\K{cmdJoin}) commands) are created in the same layer as the associated object(s). +Each object is contained in a layer - which is a custom group of objects that do not have a particular visual order, but can be treated as a set for certain commands. +Objects which are created independently of other objects (such as straight tracks (\K{cmdStraight}) or text (\K{cmdText})) are created in the current layer. +Objects which are associated with other objects (such as tracks created by the \f{Modify} (\K{cmdModify}) or \f{Join} (\K{cmdJoin}) commands) are created in the same layer as the associated object(s). The \f{Layers} dialog allows you to change various attributes of each of the 99 possible \f{layers}. -Attributes associated with a layout are stored within the associated layout file and apply only to the layout that's open at the time of a change. It is possible to apply attributes from one layout file to another using the \f{Load} and \f{Save} buttons. +Attributes associated with a layout are stored within the associated layout file and apply only to the layout that's open at the time of a change. +It is possible to apply attributes from one layout file to another using the \f{Load} and \f{Save} buttons. \G{png.d/dlayers.png} -The drop down list at the top of the dialog selects the \f{Layer} you are interested in. Non-empty layers are preceded by a \c{+}. +The drop down list at the top of the dialog selects the \f{Layer} you are interested in. Frozen layers are preceeded by a \c{*}, Module layers are proceeded by a \c{m}, non-empty layers are preceded by a \c{+} and empty layers by a \c{-}. The \f{Name} edit box contains the name of the \f{Layer}. This name is listed in the \f{Current Layer} drop down list on the \f{Tool-bar} (\K{mainW}). Also the \f{Name} is displayed as the balloon help for the corresponding \f{Layer Button}. @@ -378,10 +424,19 @@ The \f{Frozen} check-box indicates that tracks in that \f{Layer} can not be modi The \f{On Map} check-box controls whether the \f{Layer} is drawn on the Map (\K{cmdMap}) window. -The \f{Module} check-box controls whether the \f{Layer} is selected/deselected and so moved or rotated as a group - this can be used to denote a track module in a modular layout - allowing the modules to be positioned as units. Objects in a Module Layer can not be individually modified. One way of getting a modules in is to build a library with \f{Export} and then \f{Import As Module} - this creates one layer per module, names it and sets the \f{Module} check-box. +The \f{Module} check-box controls whether the \f{Layer} is selected/deselected and so moved or rotated as a group - this can be used to denote a track module in a modular layout - allowing the modules to be positioned as units. +Objects in a Module Layer can not be individually modified. +One way of getting a modules in is to build a library with \f{Export} and then \f{Import As Module} - this creates one layer per module, names it and sets the \f{Module} check-box. + +The \f{No Button} check-box selects if the \f{Layer} has a button to hide/show it. You may choose not to have a button if the layer is empty or if it is a sub-layer controlled by another layer. + +The \f{Linked Layers} text box can contain a semi-colon-delimited set of layer numbers that will be shown and hidden along with this layer when its show/hidden state is changed. A blank means no layers are linked. The layers can have buttons or not. You cannot uncheck \f{Visible} or check \f{Frozen} for the \f{Current Layer}. +The \f{Load Settings} specifies a settings (.xset) filename in the XTrackCAD working directory that is loaded when this layer is made current. Only the values contained in the file will be set. +If this name is blank the default values (all those in use when any layer that has no Load Settings file value was last used) will be reloaded (or retained). The dropbox contains all the names of files in that directory. + The \f{Count} field displays the number of objects in the selected Layer. The \f{Save} button stores layer attributes in the \c{xtrkcad.ini} file so they may be loaded into an existing or new file. Once saved and unless reset to \e{XTrackCAD} \f{Default}, modified layer information is applied to each new file. @@ -390,7 +445,7 @@ The \f{Load} button reads layer attributes from the \c{xtrkcad.ini} file then ap The \f{Defaults} button restores layer attributes to default \e{XTrackCAD} settings. -The bottom of the dialog contains the \f{Number of Layer Buttons} integer edit box. This controls the number of \f{Layer Buttons} displayed on the \f{Tool-bar} (\K{mainW}). These buttons make it easy to switch between layers. The maximum number of \f{Layer Buttons} that can be displayed is 20. Therefore you should use layers one to twenty for objects which you will be showing and hiding frequently. +The bottom of the dialog contains the \f{Number of Layer Buttons} integer edit box. This controls the number of \f{Layer Buttons} displayed on the \f{Tool-bar} (\K{mainW}). These buttons make it easy to switch between layers. The maximum number of \f{Layer Buttons} that can be displayed is 99. Layers with "no-button" set do not count towards the Number of Layer Buttons. \G{png.d/blayer.png} @@ -410,10 +465,12 @@ Objects are drawn on the map window, if the Layer they are on has \f{On Map} che \rule -\S{cmdEnum} Parts List +\S{cmdEnum} \i{Parts List} \I{Enumerate} The \f{Parts List} command produces a list of all selected (\K{cmdSelect}) turnouts, sectional track and bench-work. It also computes total length of selected flex-track. +If no objects are selected, all objects are enumerated. + \G{png.d/partslist.png} The \f{Save As...} button opens a \e{File Save} dialog window that's used to name and save the parts list to a file. @@ -424,11 +481,13 @@ The \f{Close} button terminates the \f{Parts List} command. The \f{Parts List} dialog will list pricing for selected objects if the \e{Prices} check box is checked. Prices are set using the Price List (\K{cmdPricelist}) dialog. -Hint: use the \f{Parts List} command to measure the length of selected flex-track. +The \f{Parts List} dialog will list the index numbers of each type of named track in a comma delimited list on a new line if the \e{Indexes} check box is checked. This list can be used in the Select By Index (\K{cmdSelectIndex}) command. + +Hint: you can use the \f{Parts List} command to measure the length of selected flex-track. \rule -\S{cmdPricelist} Price List +\S{cmdPricelist} \i{Price List} The \f{Price List} dialog allows entry of prices for Turnouts, Sectional Track and Structures. Only those objects from loaded Parameter Files (\K{cmdPrmfile}) or \e{Custom Designs} for the current Scale (\K{cmdLayout}) are listed. @@ -436,17 +495,18 @@ The \f{Price List} dialog allows entry of prices for Turnouts, Sectional Track a The price of a selected object can be changed in the \e{Cost} edit box that's located above the "Price" column. -The price of a length of \e{Flex Track} for the current Scale (\K{cmdLayout}) is listed at the bottom of the dialog. You can specify the \e{Length} in \e{Inches} or \e{Centimeters}. To specify the price for other \e{Scales} change Scale (\K{cmdLayout}) on the Layout (\K{cmdLayout}) window. +The price of a length of \e{Flex-Track} for the current Scale (\K{cmdLayout}) is listed at the bottom of the dialog. You can specify the \e{Length} in \e{Inches} or \e{Centimeters}. To specify the price for other \e{Scales} change Scale (\K{cmdLayout}) on the Layout (\K{cmdLayout}) window. The Parts List (\K{cmdEnum}) dialog lists prices for selected objects if the \e{Prices} check box on the dialog window is selected. \rule -\S{cmdTrain} Train +\S{cmdTrain} \i{Train Mode} \I{Simulation} \G{png.d/btrain.png} The \f{Train} command lets you place and run Trains on the layout. \I{Run Trains}During this command, the Tool Bar and Hot Bar are changed. Most of the Tool Bar buttons are replaced by the \e{Go/Stop} and \e{Exit} buttons. The \e{Go/Stop} button toggles between Pausing all Trains and allowing Trains to Run. The \e{Exit} button terminates the Train Simulation and returns to Layout Design mode. +The Hot Bar becomes the \f{Shelf}. \G{png.d/trainbar.png} @@ -454,19 +514,19 @@ The Parts List (\K{cmdEnum}) dialog lists prices for selected objects if the \e{ \dt \e{Selecting New Cars} -\dd The Hot Bar contains the Cars and Locomotives which are have not been placed on the Layout. Cars are created and managed using the Car Inventory (\K{cmdCarinv}) dialog. +\dd The \f{Shelf} contains the Cars and Locomotives which have not been placed on the Layout. Cars are created and managed using the Car Inventory (\K{cmdCarinv}) dialog. \u000 -\dd Each item on the Hot Bar can represent a group of Cars. Cars can be grouped by Prototype, Manufacturer and/or Part Number. They can also be listed as individual Car Items. This grouping is controlled by \e{Car Labels} Drop Down List on the Display (\K{cmdDisplay}) dialog. +\dd Each item on the \f{Shelf} can represent a group of Cars. Cars can be grouped by Prototype, Manufacturer and/or Part Number. They can also be listed as individual Car Items. This grouping is controlled by \e{Car Labels} Drop Down List on the Display (\K{cmdDisplay}) dialog. \u000 -\dd To place a Car, select it from the Hot Bar. If the Hot Bar is displaying Cars in groups (and not as individual Car Items) then a Drop Down List is displayed on the Status Bar (\K{mainW}) containing the individual Car Items in that group. +\dd To place a Car, select it from the \f{Shelf}. If the \f{Shelf} is displaying Cars in groups (and not as individual Car Items) then a Drop Down List is displayed on the Status Bar (\K{mainW}) containing the individual Car Items in that group. \u000 -\dd If you are not displaying the Hot Bar, then the \e{New Car} button (\G{png.d/bnewcar.png}) will be shown on the Tool Bar. Pressing this button will display the Drop Down List on the Status Bar (\K{mainW}) containing all of your Car Items that have not yet been placed on the layout. +\dd If you are not displaying the \f{Shelf}, then the \e{New Car} button (\G{png.d/bnewcar.png}) will be shown on the Tool Bar. Pressing this button will display the Drop Down List on the Status Bar (\K{mainW}) containing all of your Car Items that have not yet been placed on the layout. \u000 @@ -520,6 +580,12 @@ The Parts List (\K{cmdEnum}) dialog lists prices for selected objects if the \e{ \u000 +\dt \e{Change Reporting number of Car on Layout} + +\dd To change the reporting number, Right-Click over the Car and then select \e{Describe} and update the field. This value will be shown in the car if Labels are shown and in the \e{Train Control} Window. + +\u000 + \dt \e{Trains} \dd A Train consists of one or more Locomotives coupled to other Cars. One Locomotive will be the \e{MU Master} for the Train. The \e{MU Master} can be changed by Right-Clicking on a Locomotive and selecting \e{MU Master} from the pop-up menu. The \e{MU Master} is drawn with a solid Yellow head light indicating the direction is moving. If a Train is split by uncoupling between Locomotives, then two Trains will be created, each with their own \e{MU Master}. @@ -532,7 +598,7 @@ The Parts List (\K{cmdEnum}) dialog lists prices for selected objects if the \e{ \u000 -\dd The \e{Train Control} dialog is used to set the speed and direction of Trains. The dialog contains a list of Trains (listed by their \e{MU Master} Locomotive). Before each Train on the list is either a Red circle (indicating the Train is stopped) or a Green circle (indicating the Train is moving). +\dd The \e{Train Control} dialog is used to set the speed and direction of Trains. The dialog contains a list of Trains (listed by their \e{MU Master} Locomotive reporting number). Before each Train on the list is either a Red circle (indicating the Train is stopped) or a Green circle (indicating the Train is moving). \u000 @@ -602,17 +668,17 @@ The Parts List (\K{cmdEnum}) dialog lists prices for selected objects if the \e{ \u000 -\dd Turntables can be turned by using \e{Shift+Left-Click} on the endpoint you want the Turntable to move to. To turn the Turntable 180\u00B0, \e{Shift+Left-Click} on the endpoint again. +\dd Turntables can be turned by using \e{Shift+Left-Click} on the endpoint you want the Turntable bridge to move to. If you click on the Turntable where there is no endpoint, the Turntable will turn to the next endpoint beyond that point in the direction of the click relative to the nearest end of the turntable bridge. To turn the Turntable 180\u00B0, \e{Shift+Left-Click} on the current endpoint again. \rule -\S{cmdTurnoutNew} Turnout Designer +\S{cmdTurnoutNew} \i{Turnout Designer} The \f{Turnout Designer} allows you to define new turnouts and sectional track pieces. \G{png.d/mmanageturnoutdesign.png} -The Turnout Designer sub-menu is pictured above. As demonstrated by the sub-menu a number of different dialogs are available for creation of custom turnout and sectional track components. New turnouts and sectional track is added to Custom Management (\K{cmdCustmgm}) and Turnout Manager (\K{cmdTurnout}) using the \f{Turnout Designer}. +The Turnout Designer sub-menu is pictured above. As demonstrated by the sub-menu a number of different dialogs are available for creation of custom turnout and sectional track components. New turnouts and sectional track is added to Custom Management (\K{cmdCustmgm}) and Turnout Manager (\K{cmdNewFixedTrack}) using the \f{Turnout Designer}. The follow dialog is for a regular turnout. @@ -660,7 +726,7 @@ The rail height (\e{Code}) can be added to the \f{Manufacturer}, e.g., Peco-55, The scale is the current scale from the \f{Scale Drop Down List} on the \f{Layout} dialog (\K{cmdLayout}). -\f{Manufacturer}, \f{Description} and \f{Part Number (#)} comprise the title of the turnout. These values are used in the \f{Turnout Selection dialog} (\K{cmdTurnout}) and the \f{Parts List} (\K{cmdEnum}). For regular and curved turnouts there are separate \f{Descriptions} and \f{Part Numbers} for the right and left hand turnouts. +\f{Manufacturer}, \f{Description} and \f{Part Number (#)} comprise the title of the turnout. These values are used in the \f{Turnout Selection dialog} (\K{cmdNewFixedTrack}) and the \f{Parts List} (\K{cmdEnum}). For regular and curved turnouts there are separate \f{Descriptions} and \f{Part Numbers} for the right and left hand turnouts. The \f{Print} button prints a full size diagram of the turnout. You can use this to check your dimensions and make any required changes. You should expect to make several printouts as you refine your dimensions. @@ -668,7 +734,7 @@ The \f{OK} button completes the design. The new turnout is added to the list in The \f{Cancel} button removes the \f{Turnout Designer} dialog. -\e{Creating \i{Turnout Designs}} +\e{Creating Turnout Designs} \b It is best to start by marking the endpoints of the turnout on a piece of paper. Extend the curved leg of the turnout (try attaching a straight sectional track) and measure the angle. Frog numbers are easiest to calculate. @@ -688,7 +754,7 @@ The \f{Cancel} button removes the \f{Turnout Designer} dialog. \rule -\S{cmdRefreshSpecial} Update Turnouts and Structures +\S{cmdRefreshSpecial} \i{Update Turnouts and Structures} This command updates (or refreshes) selected turnouts, sectional tracks and structures on your layout with the current definitions from the loaded parameter files (\K{cmdPrmfile}). Each selected object that is found in a parameter file is updated with the current definition. @@ -700,8 +766,11 @@ If an object has been updated then it is unselected, otherwise it will remain se \rule -\S{cmdUngroup} Ungroup +\S{cmdUngroup} \i{Ungroup} \f{Ungroup} allows existing definitions to be modified and the resulting objects recombined with the \f{Group} (\K{cmdGroup}) command to update the definition. Turnouts are composed of individual straight and curved segments. Segments that form the points (\K{generalTerms}) of the turnout remain combined as an \e{Ungrouped Turnout}, and the other segments are replaced by straight and curved tracks. -\rule
\ No newline at end of file +One-ended Turnouts (AKA Bumpers) are converted to Staight tracks by \f{Ungroup}. +These can be converted back to a Bumper by manually editting the \f{Grouped} definition and removing the unwanted End-Point by deleting the correspnding \f{E} line. + +\rule diff --git a/app/doc/mk-xtrkcad-manual-html b/app/doc/mk-xtrkcad-manual-html new file mode 100755 index 0000000..9340b1d --- /dev/null +++ b/app/doc/mk-xtrkcad-manual-html @@ -0,0 +1,93 @@ +#!/bin/sh + +if [ $# -ne 3 ] ; then + echo mk-xtrkcad-manual-html SRCDIR BINDIR OUTFILE + echo SRCDIR contains .but files + echo BINDIR contains .html files + echo OUTFILE is the output .html file + echo Open OUTFILE in Chrome and print as pdf + echo from a directory which contains png.d + exit 1 +fi + +SRCDIR=$1 +BINDIR=$2 +OUTFILE=$3 +OUTDIR=`pwd` + +if [ ! -d ${SRCDIR} ] ; then + echo $SRCDIR does not exist + exit 1 +fi + +if [ ! -f ${SRCDIR}/addm.but ] ; then + echo $SRCDIR does not contain .but files + exit 1 +fi + +if [ ! -d ${SRCDIR}/png.d ] ; then + echo $SRCDIR does not contain png.d directory + exit 1 +fi + +if [ ! -d ${BINDIR} ] ; then + echo $BINDIR does not exist + exit 1 +fi + +if [ ! -f ${BINDIR}/addM.html ] ; then + echo $BINDIR does not contain .html files + exit 1 +fi + + +extract() { + grep '^\\[ACHS]' $1 |\ + sed \ + -e 's/^\\[ACHS][0-9]*{//' \ + -e 's/}.*//' \ + -e '/^$/d' \ + -e 's/$/.html/' ; +} + +cd $SRCDIR +# extract .html refs +FILES="\ +contents.html \ +`extract intro.but.in` \ +`extract addm.but` \ +`extract changem.but` \ +`extract drawm.but` \ +`extract editm.but` \ +`extract filem.but` \ +`extract helpm.but` \ +`extract hotbar.but` \ +`extract macrom.but` \ +`extract managem.but` \ +`extract optionm.but` \ +`extract statusbar.but` \ +`extract view_winm.but` \ +`extract navigation.but` \ +`extract appendix.but` \ +`extract ${BINDIR}/../../help/messages.but` \ +`extract upgrade.but` \ +`extract warranty.but` \ +IndexPage.html" + +cd $OUTDIR +( +cd $BINDIR +# clean up html: remove nav line, fix case file names +cat $FILES |\ + grep -v 'Previous.*Next' |\ + sed \ + -e 's/bSensor.png/bsensor.png/'\ + -e 's/bControl.png/bcontrol.png/'\ + -e 's/iconlink.PNG/iconlink.png/'\ + ) > ${OUTFILE} + +echo "Combined .html files are in ${OUTFILE}" +echo "Make sure ${OUTFILE} is in a directory which contains a link to" +echo " $SRCDIR/png.d/" +echo "Open with Chrome and Print to File as a PDF" +echo "You should specify a custom scale of at least 150%" diff --git a/app/doc/navigation.but b/app/doc/navigation.but index e0269f4..ff20b41 100644 --- a/app/doc/navigation.but +++ b/app/doc/navigation.but @@ -138,12 +138,13 @@ Eg. in Germany, where the comma is used, the correct value would be\c{LargeIcon \b "@" key in \f{Select}, \f{Modify} and \f{Pan/Zoom}. -\b Mouse Wheel - adding \e{Shift} key or the \e{Mouse Middle Button} will Pan the screen. adding \e{Ctrl} as well makes up Pan left and down Pan right. +\b Mouse Wheel - adding \e{Shift} key will Pan the screen up and down. Adding \e{Ctrl} as well Pans left and right. -\b Horizontal Mouse Wheel - adding \e{Shift} or the \e{Mouse Middle Button} will Pan the screen left and Right (if available) +\b Horizontal Mouse Wheel - adding \e{Shift} key will Pan the screen left and Right (if available) \b Scroll Left and Right - if the scroll left and right guestures are mapped to the trackpad by the operating system, with \e{Shift} depressed the screen will Pan. +\b On mice and systems that support Three Button Mice, holding the \e{Middle Mouse Button} while dragging, will Pan the canvas. } \dd The \f{Main Canvas} can be panned so that the area beyond the room boundaries is shown (the \f{grey} area). The \f{Constrain Drawing Area to Room Boundaries} option on the \f{Display} (\K{cmdDisplay}) dialog under the \f{Options} (\K{optionM}) menu forces the \f{Main Canvas} stop panning once the room boundary is reached. @@ -245,15 +246,17 @@ Lengths and Distances can be entered in a variety of formats; \u000 -\dd Pressing the Equal Sign (\c{=}) key after an entry will reformat the value entered to your preferred length format (\K{cmdPref}). +\dd Adding the Equal Sign (\c{=}) key after an entry will reformat the value entered to your preferred length format (\K{cmdPref}). \u000 -\dd Pressing the "\c{p}" key after an entry will convert a prototype measurement to a scale measurement by dividing the value entered by the ratio for the current scale. +\dd Adding the "\c{p}" key after an entry will convert a prototype measurement to a scale measurement by dividing the value entered by the ratio for the current scale. \u000 -\dd Pressing the "\c{s}" key after an entry will convert a scale measurement to a prototype measurement. +\dd Adding the "\c{s}" key after an entry will convert a scale measurement to a prototype measurement. + +The conversion will happen when the \e{Tab} key is used, or the cursor is moved to a different entry box. \rule @@ -300,7 +303,7 @@ Instead of using the menus or the buttons on the \f{Tool-bar} (\K{mainW}), most \u000 -\dd The \c{DELETE} key invokes the \f{Delete} (\K{cmdDelete}) command. +\dd The \c{DELETE} or the \c{BackSpace} key invokes the \f{Delete} (\K{cmdDelete}) command. Several Shortcut key commands are used in conjunction with the mouse. These commands are listed in \K{cmdAcclKeys}. @@ -418,7 +421,7 @@ Several Shortcut key commands are used in conjunction with the mouse. These comm \u000 -\dd Split flex track - \e{Ctrl+Shift+S} +\dd Split flex-track - \e{Ctrl+Shift+S} \u000 @@ -754,6 +757,8 @@ Note Dialog } } +\dd On some systems support Three Button Mice, holding down the \e{Middle Mouse Button} and dragging will pan the Canvas. Note: not all system support this operation, even with a Three Button Mouse. + \rule \S{cmdManage} Manage Commands @@ -936,7 +941,7 @@ Some other commands use the \c{Shift} or \c{Ctrl} key to modify the meaning of b \rule -\S{mouseBcmd} Context Sensitive Menus +\S{mouseBcmd} \i{Context Sensitive Menus} For all commands listed below, a \e{Right-Click} will display a context sensitive pop-up command list menu. For some commands (noted below), a \e{Shift+Right-Click} will display a context sensitive pop-up command options menu. The operation of \e{Right-Click} and \e{Shift+Right-Click} can be reversed by an item on the Command Options (\K{cmdCmdopt}) dialog. @@ -1136,6 +1141,10 @@ The Shortcut key for each command is listed after the command name. \u000 +\dt Angle Command (\K{cmdAngle}) + +\dd Position Protractor - \e{Left-Drag} + \dt Select Command (\K{cmdSelect}) - \e{Ctrl+E} @@ -1230,7 +1239,7 @@ The Shortcut key for each command is listed after the command name. \u000 -\dt Turnout Command (\K{cmdTurnout}) - \e{Ctrl+T} +\dt Turnout Command (\K{cmdNewFixedTrack}) - \e{Ctrl+T} \dd Choose next Active endpoint when placing Turnouts - \e{Shift+Left-Click} diff --git a/app/doc/optionm.but b/app/doc/optionm.but index 8876d96..1398ad9 100644 --- a/app/doc/optionm.but +++ b/app/doc/optionm.but @@ -44,7 +44,7 @@ The \f{Options Menu} shows commands to change configuration options. \rule -\S{cmdRgbcolor} Colors Dialog +\S{cmdRgbcolor} \i{Colors Dialog} The \f{Colors} dialog is invoked from the Options (\K{optionM}) menu @@ -90,10 +90,18 @@ The \f{Colors} dialog controls the color that various objects are drawn. \dd \f{Track Ties} - color of ties (if drawn). +\u000 + +\dd \f{Bridge Base} - color of Bridge fill between the parapets. + +\u000 + +\dd \f{Track Roadbed} - color of Roadbed fill under the track. + \rule -\S{cmdCmdopt} Command Option Dialog +\S{cmdCmdopt} \i{Command Option Dialog} The \f{Command Option} dialog is invoked from the Options (\K{optionM}) menu @@ -109,7 +117,7 @@ The \f{Command Option} dialog contains items which control the behavior of some \u000 -\dd \e{Select-Mode} - will either (a) only select the current item unless Ctrl is added or (b) will add the current item to the selection unless Ctrl is added in which case it will only select this item. +\dd \e{Select-Mode} - will either (a) only select the current item unless Ctrl is added or (b) will add the current item to the selection unless Ctrl is added in which case it will only select this item. \u000 @@ -118,7 +126,7 @@ The \f{Command Option} dialog contains items which control the behavior of some \rule -\S{cmdDisplay} Display Dialog +\S{cmdDisplay} \i{Display Dialog} The \f{Display} dialog is invoked from the Options (\K{optionM}) menu @@ -149,6 +157,10 @@ Setting this option constrains the Main Canvas to minimize these areas (the \f{g \u000 +\dd \f{Dont Hide System Cursor} - when XTrackCAD substitutes a specialized cursor to show actions that will occur (or are occuring) it will normallly hide the System Cursor. This option suppresses this behaviour and leaves the system cursor in place. + +\u000 + \dd \f{Draw EndPts} - when to draw endpoints between connected track: never, only for turnouts or for all tracks. \u000 @@ -183,13 +195,13 @@ Setting this option constrains the Main Canvas to minimize these areas (the \f{g \u000 -\b \e{Cars} - Reporting mark labels on cars. +\b \e{Cars} - Reporting mark labels on cars - the content shown on the Cars label is either the Repmarks (if the Rep Number is set), or the car index number (with a "#" before it). See the Car Part dialog \K{carpart}. \b \e{EndPt Elevations} - Elevation markers attached to endpoints. -\b \e{Lengths} - Length of flex-track attached to ends of turnouts. +\b \e{Lengths} - Length of flex-track attached to ends of turnouts all the way to the next turnout. -\b \e{Track Descriptions} - Title of each turnout and sectional track. +\b \e{Track Descriptions} - Title of each turnout and sectional track, optional details of each piece of Flexible Track. These can be shown or hidden using the Move Description \K{cmdMoveLabel} command. \b \e{Track Elevations} - Computed elevations at the center of each track. @@ -201,11 +213,11 @@ Setting this option constrains the Main Canvas to minimize these areas (the \f{g \u000 -\dd \f{Layout Labels} - controls the format of titles for turnouts and structures displayed on the Layout. +\dd \f{Layout Labels} - controls the format of titles for Turnouts and Structures displayed on the Layout. \u000 -\dd \f{Label Scale} - draw labels only when the drawing Scale is smaller or equal to this value. +\dd \f{Label Scale} - the program will draw labels only when the drawing Scale is smaller or equal to this value. \u000 @@ -321,7 +333,7 @@ Easements require the possibility of creating track with arbitrary radii. Theref \rule -\S{fontSelW} Font Selection +\S{fontSelW} \i{Font Selection} The font selection dialog allows selection of the font used by the text (\K{cmdText}) command. This command is valid only on UNIX based systems. @@ -330,7 +342,7 @@ The font selection dialog allows selection of the font used by the text (\K{cmdT \rule -\S{cmdLayout} Layout Dialog +\S{cmdLayout} \i{Layout Dialog} The \f{Layout Options} dialog, displayed by the Options (\K{optionM}) or the File (\K{fileM} menu, contains items controlling the current layout. @@ -391,7 +403,7 @@ It can be changed to a new local file and the next \f{Save} will rebuild the pac \rule -\S{cmdPref} Preferences Dialog +\S{cmdPref} \i{Preferences Dialog} This dialog controls some parameters which likely will not be changed frequently. @@ -403,7 +415,7 @@ This dialog controls some parameters which likely will not be changed frequently \u000 -\dd \f{AutoSave} \i{AutoSave} - specifies the number of Check Points taken before an AutoSave. The same number of checkpoints are retained in a circular archive set in the (\K{workDir}) named for the layout file. Setting this value to 0 disables AutoSave. +\dd \f{AutoSave} \i{AutoSave} - specifies the number of Check Points taken before an AutoSave. The same number of checkpoints are retained in a circular archive set in the (\K{workDir}) named for the layout file. Setting this value to 0 disables AutoSave. \u000 @@ -411,7 +423,7 @@ This dialog controls some parameters which likely will not be changed frequently \u000 -\dd \f{Show FlexTrack} - disables the display or \f{FlexTrack} (\K{generalTerms}) which is shown on the left of the Toolbar. +\dd \f{Show Flex-track} - disables the display or \f{Flex-track} (\K{generalTerms}) which is shown on the left of the Toolbar. \u000 @@ -461,10 +473,18 @@ This dialog controls some parameters which likely will not be changed frequently \dd \f{Units} - choose between English (inches) or Metric (centimeters) measurements. +\u000 + +\dd \f{Write Settings} - Save the current settings to a named settings file + +\u000 + +\dd \f{Read Settings} - Load settings from a named settings file + \rule -\S{cmdSticky} Sticky Dialog +\S{cmdSticky} \i{Sticky Dialog} By default, when commands complete, the defined \f{Default Command} (\K{cmdCmdopt}) becomes active. If a command is \f{sticky}, the defined \f{Default Command} is ignored and the current command remains active after completion. diff --git a/app/doc/png.d/bangle.png b/app/doc/png.d/bangle.png Binary files differnew file mode 100644 index 0000000..c7977f5 --- /dev/null +++ b/app/doc/png.d/bangle.png diff --git a/app/doc/png.d/bblock.png b/app/doc/png.d/bblock.png Binary files differindex ccd90d9..50b2e09 100644 --- a/app/doc/png.d/bblock.png +++ b/app/doc/png.d/bblock.png diff --git a/app/doc/png.d/bbridge.png b/app/doc/png.d/bbridge.png Binary files differnew file mode 100644 index 0000000..438afe3 --- /dev/null +++ b/app/doc/png.d/bbridge.png diff --git a/app/doc/png.d/bcircl1.png b/app/doc/png.d/bcircl1.png Binary files differindex aa53512..a6177f2 100644 --- a/app/doc/png.d/bcircl1.png +++ b/app/doc/png.d/bcircl1.png diff --git a/app/doc/png.d/bcircl2.png b/app/doc/png.d/bcircl2.png Binary files differindex 1df9bfc..3632d10 100644 --- a/app/doc/png.d/bcircl2.png +++ b/app/doc/png.d/bcircl2.png diff --git a/app/doc/png.d/bcircl3.png b/app/doc/png.d/bcircl3.png Binary files differindex 4e7a34c..020111d 100644 --- a/app/doc/png.d/bcircl3.png +++ b/app/doc/png.d/bcircl3.png diff --git a/app/doc/png.d/bcircle.png b/app/doc/png.d/bcircle.png Binary files differindex 3fecbe3..db00f4e 100644 --- a/app/doc/png.d/bcircle.png +++ b/app/doc/png.d/bcircle.png diff --git a/app/doc/png.d/bconnect.png b/app/doc/png.d/bconnect.png Binary files differindex 840fa82..77766e1 100644 --- a/app/doc/png.d/bconnect.png +++ b/app/doc/png.d/bconnect.png diff --git a/app/doc/png.d/bcontrol.png b/app/doc/png.d/bcontrol.png Binary files differindex 131bb94..2b67c52 100644 --- a/app/doc/png.d/bcontrol.png +++ b/app/doc/png.d/bcontrol.png diff --git a/app/doc/png.d/bcornu.png b/app/doc/png.d/bcornu.png Binary files differindex 6844a84..dd21a5b 100644 --- a/app/doc/png.d/bcornu.png +++ b/app/doc/png.d/bcornu.png diff --git a/app/doc/png.d/bcurve.png b/app/doc/png.d/bcurve.png Binary files differindex 8cb3ae7..25d2f1c 100644 --- a/app/doc/png.d/bcurve.png +++ b/app/doc/png.d/bcurve.png diff --git a/app/doc/png.d/bcurve1.png b/app/doc/png.d/bcurve1.png Binary files differindex f6e594c..12a35b6 100644 --- a/app/doc/png.d/bcurve1.png +++ b/app/doc/png.d/bcurve1.png diff --git a/app/doc/png.d/bcurve2.png b/app/doc/png.d/bcurve2.png Binary files differindex 6ad7001..3d0266d 100644 --- a/app/doc/png.d/bcurve2.png +++ b/app/doc/png.d/bcurve2.png diff --git a/app/doc/png.d/bcurve3.png b/app/doc/png.d/bcurve3.png Binary files differindex 1e84751..4989626 100644 --- a/app/doc/png.d/bcurve3.png +++ b/app/doc/png.d/bcurve3.png diff --git a/app/doc/png.d/bcurve4.png b/app/doc/png.d/bcurve4.png Binary files differindex 87fb172..e1479fd 100644 --- a/app/doc/png.d/bcurve4.png +++ b/app/doc/png.d/bcurve4.png diff --git a/app/doc/png.d/bcurvelin.png b/app/doc/png.d/bcurvelin.png Binary files differnew file mode 100644 index 0000000..349c1a9 --- /dev/null +++ b/app/doc/png.d/bcurvelin.png diff --git a/app/doc/png.d/bdelete.png b/app/doc/png.d/bdelete.png Binary files differindex 75038e7..6e46e43 100644 --- a/app/doc/png.d/bdelete.png +++ b/app/doc/png.d/bdelete.png diff --git a/app/doc/png.d/bdescrib.png b/app/doc/png.d/bdescrib.png Binary files differindex f501f13..3525e0c 100644 --- a/app/doc/png.d/bdescrib.png +++ b/app/doc/png.d/bdescrib.png diff --git a/app/doc/png.d/bdraw.png b/app/doc/png.d/bdraw.png Binary files differindex 540cce9..c22006b 100644 --- a/app/doc/png.d/bdraw.png +++ b/app/doc/png.d/bdraw.png diff --git a/app/doc/png.d/bdrawsplit.png b/app/doc/png.d/bdrawsplit.png Binary files differnew file mode 100644 index 0000000..5174bec --- /dev/null +++ b/app/doc/png.d/bdrawsplit.png diff --git a/app/doc/png.d/beasement.png b/app/doc/png.d/beasement.png Binary files differindex 1e4bd1a..b1c456a 100644 --- a/app/doc/png.d/beasement.png +++ b/app/doc/png.d/beasement.png diff --git a/app/doc/png.d/belev.png b/app/doc/png.d/belev.png Binary files differindex 6ecb86a..eb16a12 100644 --- a/app/doc/png.d/belev.png +++ b/app/doc/png.d/belev.png diff --git a/app/doc/png.d/bexport.png b/app/doc/png.d/bexport.png Binary files differnew file mode 100644 index 0000000..dd3b90e --- /dev/null +++ b/app/doc/png.d/bexport.png diff --git a/app/doc/png.d/bexportbmap.png b/app/doc/png.d/bexportbmap.png Binary files differnew file mode 100644 index 0000000..1f749e7 --- /dev/null +++ b/app/doc/png.d/bexportbmap.png diff --git a/app/doc/png.d/bexportdxf.png b/app/doc/png.d/bexportdxf.png Binary files differnew file mode 100644 index 0000000..e593c52 --- /dev/null +++ b/app/doc/png.d/bexportdxf.png diff --git a/app/doc/png.d/bexportsvg.png b/app/doc/png.d/bexportsvg.png Binary files differnew file mode 100644 index 0000000..8dea55c --- /dev/null +++ b/app/doc/png.d/bexportsvg.png diff --git a/app/doc/png.d/bezier.png b/app/doc/png.d/bezier.png Binary files differindex e03458e..796b7f2 100644 --- a/app/doc/png.d/bezier.png +++ b/app/doc/png.d/bezier.png diff --git a/app/doc/png.d/bfile.png b/app/doc/png.d/bfile.png Binary files differindex 895f376..8d7be9d 100644 --- a/app/doc/png.d/bfile.png +++ b/app/doc/png.d/bfile.png diff --git a/app/doc/png.d/bflip.png b/app/doc/png.d/bflip.png Binary files differindex cdf548a..462cd43 100644 --- a/app/doc/png.d/bflip.png +++ b/app/doc/png.d/bflip.png diff --git a/app/doc/png.d/bgsnap.png b/app/doc/png.d/bgsnap.png Binary files differindex 1cf93fa..c3a69e6 100644 --- a/app/doc/png.d/bgsnap.png +++ b/app/doc/png.d/bgsnap.png diff --git a/app/doc/png.d/bgundo.png b/app/doc/png.d/bgundo.png Binary files differindex 25dcac1..0af47ef 100644 --- a/app/doc/png.d/bgundo.png +++ b/app/doc/png.d/bgundo.png diff --git a/app/doc/png.d/bgzoom.png b/app/doc/png.d/bgzoom.png Binary files differindex 9de3726..0e3e2af 100644 --- a/app/doc/png.d/bgzoom.png +++ b/app/doc/png.d/bgzoom.png diff --git a/app/doc/png.d/bhelix.png b/app/doc/png.d/bhelix.png Binary files differindex fab3d1a..f6896fb 100644 --- a/app/doc/png.d/bhelix.png +++ b/app/doc/png.d/bhelix.png diff --git a/app/doc/png.d/bhndldto.png b/app/doc/png.d/bhndldto.png Binary files differindex 7b362c2..bb89eec 100644 --- a/app/doc/png.d/bhndldto.png +++ b/app/doc/png.d/bhndldto.png diff --git a/app/doc/png.d/bimport.png b/app/doc/png.d/bimport.png Binary files differnew file mode 100644 index 0000000..66488b9 --- /dev/null +++ b/app/doc/png.d/bimport.png diff --git a/app/doc/png.d/bimportmod.png b/app/doc/png.d/bimportmod.png Binary files differnew file mode 100644 index 0000000..ee4f375 --- /dev/null +++ b/app/doc/png.d/bimportmod.png diff --git a/app/doc/png.d/bitmap.png b/app/doc/png.d/bitmap.png Binary files differindex 33471c8..28fcabb 100644 --- a/app/doc/png.d/bitmap.png +++ b/app/doc/png.d/bitmap.png diff --git a/app/doc/png.d/bjoin.png b/app/doc/png.d/bjoin.png Binary files differindex 673793e..e3d91d1 100644 --- a/app/doc/png.d/bjoin.png +++ b/app/doc/png.d/bjoin.png diff --git a/app/doc/png.d/bjoinline.png b/app/doc/png.d/bjoinline.png Binary files differindex 0d88a58..28ea14d 100644 --- a/app/doc/png.d/bjoinline.png +++ b/app/doc/png.d/bjoinline.png diff --git a/app/doc/png.d/blayer.png b/app/doc/png.d/blayer.png Binary files differindex 8b2fe72..2817ea9 100644 --- a/app/doc/png.d/blayer.png +++ b/app/doc/png.d/blayer.png diff --git a/app/doc/png.d/blink.png b/app/doc/png.d/blink.png Binary files differindex 4dfbbe7..70479c1 100644 --- a/app/doc/png.d/blink.png +++ b/app/doc/png.d/blink.png diff --git a/app/doc/png.d/bmap.png b/app/doc/png.d/bmap.png Binary files differindex 7a99724..98b4a6f 100644 --- a/app/doc/png.d/bmap.png +++ b/app/doc/png.d/bmap.png diff --git a/app/doc/png.d/bmcircle.png b/app/doc/png.d/bmcircle.png Binary files differindex fc26dbf..ca7017f 100644 --- a/app/doc/png.d/bmcircle.png +++ b/app/doc/png.d/bmcircle.png diff --git a/app/doc/png.d/bmcurved.png b/app/doc/png.d/bmcurved.png Binary files differindex 0feef79..1c76f6a 100644 --- a/app/doc/png.d/bmcurved.png +++ b/app/doc/png.d/bmcurved.png diff --git a/app/doc/png.d/bmenu.png b/app/doc/png.d/bmenu.png Binary files differindex 75cc557..79dd813 100644 --- a/app/doc/png.d/bmenu.png +++ b/app/doc/png.d/bmenu.png diff --git a/app/doc/png.d/bmodify.png b/app/doc/png.d/bmodify.png Binary files differindex c33196a..8a5a77c 100644 --- a/app/doc/png.d/bmodify.png +++ b/app/doc/png.d/bmodify.png diff --git a/app/doc/png.d/bmove.png b/app/doc/png.d/bmove.png Binary files differindex 311d9aa..ab3639f 100644 --- a/app/doc/png.d/bmove.png +++ b/app/doc/png.d/bmove.png diff --git a/app/doc/png.d/bmovedes.png b/app/doc/png.d/bmovedes.png Binary files differindex fcff047..cdda765 100644 --- a/app/doc/png.d/bmovedes.png +++ b/app/doc/png.d/bmovedes.png diff --git a/app/doc/png.d/bnew.png b/app/doc/png.d/bnew.png Binary files differindex 7ffeb65..e02cfa6 100644 --- a/app/doc/png.d/bnew.png +++ b/app/doc/png.d/bnew.png diff --git a/app/doc/png.d/bnewcar.png b/app/doc/png.d/bnewcar.png Binary files differindex a83f9da..c7773dc 100644 --- a/app/doc/png.d/bnewcar.png +++ b/app/doc/png.d/bnewcar.png diff --git a/app/doc/png.d/bnote.png b/app/doc/png.d/bnote.png Binary files differindex da70589..ade9df5 100644 --- a/app/doc/png.d/bnote.png +++ b/app/doc/png.d/bnote.png diff --git a/app/doc/png.d/bopen.png b/app/doc/png.d/bopen.png Binary files differindex 247fe38..89e08cb 100644 --- a/app/doc/png.d/bopen.png +++ b/app/doc/png.d/bopen.png diff --git a/app/doc/png.d/bparallel.png b/app/doc/png.d/bparallel.png Binary files differindex 5f92b6d..47b7631 100644 --- a/app/doc/png.d/bparallel.png +++ b/app/doc/png.d/bparallel.png diff --git a/app/doc/png.d/bparalleline.png b/app/doc/png.d/bparalleline.png Binary files differindex 43a6223..9e2f4dd 100644 --- a/app/doc/png.d/bparalleline.png +++ b/app/doc/png.d/bparalleline.png diff --git a/app/doc/png.d/bparam.png b/app/doc/png.d/bparam.png Binary files differnew file mode 100644 index 0000000..7e49dfc --- /dev/null +++ b/app/doc/png.d/bparam.png diff --git a/app/doc/png.d/bprint.png b/app/doc/png.d/bprint.png Binary files differnew file mode 100644 index 0000000..43a7c45 --- /dev/null +++ b/app/doc/png.d/bprint.png diff --git a/app/doc/png.d/brevert.png b/app/doc/png.d/brevert.png Binary files differnew file mode 100644 index 0000000..57f6d72 --- /dev/null +++ b/app/doc/png.d/brevert.png diff --git a/app/doc/png.d/broadbed.png b/app/doc/png.d/broadbed.png Binary files differnew file mode 100644 index 0000000..86325a0 --- /dev/null +++ b/app/doc/png.d/broadbed.png diff --git a/app/doc/png.d/brotate.png b/app/doc/png.d/brotate.png Binary files differindex b2bdd6e..731b943 100644 --- a/app/doc/png.d/brotate.png +++ b/app/doc/png.d/brotate.png diff --git a/app/doc/png.d/bruler.png b/app/doc/png.d/bruler.png Binary files differindex 85184dd..2d68473 100644 --- a/app/doc/png.d/bruler.png +++ b/app/doc/png.d/bruler.png diff --git a/app/doc/png.d/bsave.png b/app/doc/png.d/bsave.png Binary files differindex deb9d7c..8f3fca8 100644 --- a/app/doc/png.d/bsave.png +++ b/app/doc/png.d/bsave.png diff --git a/app/doc/png.d/bsaveas.png b/app/doc/png.d/bsaveas.png Binary files differnew file mode 100644 index 0000000..534babd --- /dev/null +++ b/app/doc/png.d/bsaveas.png diff --git a/app/doc/png.d/bselect.png b/app/doc/png.d/bselect.png Binary files differindex b47a3f4..1768915 100644 --- a/app/doc/png.d/bselect.png +++ b/app/doc/png.d/bselect.png diff --git a/app/doc/png.d/bsensor.png b/app/doc/png.d/bsensor.png Binary files differindex 7d9834b..deeed57 100644 --- a/app/doc/png.d/bsensor.png +++ b/app/doc/png.d/bsensor.png diff --git a/app/doc/png.d/bsetup.png b/app/doc/png.d/bsetup.png Binary files differnew file mode 100644 index 0000000..7aa4289 --- /dev/null +++ b/app/doc/png.d/bsetup.png diff --git a/app/doc/png.d/bsignal.png b/app/doc/png.d/bsignal.png Binary files differindex f6b52f8..ae853fc 100644 --- a/app/doc/png.d/bsignal.png +++ b/app/doc/png.d/bsignal.png diff --git a/app/doc/png.d/bsplit.png b/app/doc/png.d/bsplit.png Binary files differindex f9ea955..831596a 100644 --- a/app/doc/png.d/bsplit.png +++ b/app/doc/png.d/bsplit.png diff --git a/app/doc/png.d/bstraigh.png b/app/doc/png.d/bstraigh.png Binary files differindex 5b556c0..2efe34d 100644 --- a/app/doc/png.d/bstraigh.png +++ b/app/doc/png.d/bstraigh.png diff --git a/app/doc/png.d/bstruct.png b/app/doc/png.d/bstruct.png Binary files differindex 7ec6620..4930b4d 100644 --- a/app/doc/png.d/bstruct.png +++ b/app/doc/png.d/bstruct.png diff --git a/app/doc/png.d/bswitchmotor.png b/app/doc/png.d/bswitchmotor.png Binary files differindex 68d9a4a..169b2d2 100644 --- a/app/doc/png.d/bswitchmotor.png +++ b/app/doc/png.d/bswitchmotor.png diff --git a/app/doc/png.d/btext.png b/app/doc/png.d/btext.png Binary files differindex 253a810..d4115d0 100644 --- a/app/doc/png.d/btext.png +++ b/app/doc/png.d/btext.png diff --git a/app/doc/png.d/bties.png b/app/doc/png.d/bties.png Binary files differnew file mode 100644 index 0000000..c2b50a2 --- /dev/null +++ b/app/doc/png.d/bties.png diff --git a/app/doc/png.d/btop_bottom.png b/app/doc/png.d/btop_bottom.png Binary files differindex 6f3300f..ae8b2c6 100644 --- a/app/doc/png.d/btop_bottom.png +++ b/app/doc/png.d/btop_bottom.png diff --git a/app/doc/png.d/btrain.png b/app/doc/png.d/btrain.png Binary files differindex 2e39236..f84b19c 100644 --- a/app/doc/png.d/btrain.png +++ b/app/doc/png.d/btrain.png diff --git a/app/doc/png.d/btunnel.png b/app/doc/png.d/btunnel.png Binary files differindex 4f4a81f..815663a 100644 --- a/app/doc/png.d/btunnel.png +++ b/app/doc/png.d/btunnel.png diff --git a/app/doc/png.d/bturnout.png b/app/doc/png.d/bturnout.png Binary files differindex a63d6d5..9789e5a 100644 --- a/app/doc/png.d/bturnout.png +++ b/app/doc/png.d/bturnout.png diff --git a/app/doc/png.d/bturntbl.png b/app/doc/png.d/bturntbl.png Binary files differindex 9561901..d261bbb 100644 --- a/app/doc/png.d/bturntbl.png +++ b/app/doc/png.d/bturntbl.png diff --git a/app/doc/png.d/cgroup.png b/app/doc/png.d/cgroup.png Binary files differindex c42df49..7b7bffb 100644 --- a/app/doc/png.d/cgroup.png +++ b/app/doc/png.d/cgroup.png diff --git a/app/doc/png.d/cmdopt.png b/app/doc/png.d/cmdopt.png Binary files differindex b721bbc..992426d 100644 --- a/app/doc/png.d/cmdopt.png +++ b/app/doc/png.d/cmdopt.png diff --git a/app/doc/png.d/colorw.png b/app/doc/png.d/colorw.png Binary files differindex ffe5347..a0acc32 100644 --- a/app/doc/png.d/colorw.png +++ b/app/doc/png.d/colorw.png diff --git a/app/doc/png.d/convertfrom.png b/app/doc/png.d/convertfrom.png Binary files differindex 9c16665..53b55e4 100644 --- a/app/doc/png.d/convertfrom.png +++ b/app/doc/png.d/convertfrom.png diff --git a/app/doc/png.d/convertto.png b/app/doc/png.d/convertto.png Binary files differindex 9c16665..260bc1d 100644 --- a/app/doc/png.d/convertto.png +++ b/app/doc/png.d/convertto.png diff --git a/app/doc/png.d/dbench.png b/app/doc/png.d/dbench.png Binary files differindex 862f162..594bb16 100644 --- a/app/doc/png.d/dbench.png +++ b/app/doc/png.d/dbench.png diff --git a/app/doc/png.d/dbezier.png b/app/doc/png.d/dbezier.png Binary files differindex 0a81063..ca40ccb 100644 --- a/app/doc/png.d/dbezier.png +++ b/app/doc/png.d/dbezier.png diff --git a/app/doc/png.d/dbox.png b/app/doc/png.d/dbox.png Binary files differindex 7f11d4c..e03fb33 100644 --- a/app/doc/png.d/dbox.png +++ b/app/doc/png.d/dbox.png diff --git a/app/doc/png.d/dcircle1.png b/app/doc/png.d/dcircle1.png Binary files differnew file mode 100644 index 0000000..745e044 --- /dev/null +++ b/app/doc/png.d/dcircle1.png diff --git a/app/doc/png.d/dcircle2.png b/app/doc/png.d/dcircle2.png Binary files differindex 9080eaf..d39c2e3 100644 --- a/app/doc/png.d/dcircle2.png +++ b/app/doc/png.d/dcircle2.png diff --git a/app/doc/png.d/dcircle3.png b/app/doc/png.d/dcircle3.png Binary files differindex 31043e3..0676c52 100644 --- a/app/doc/png.d/dcircle3.png +++ b/app/doc/png.d/dcircle3.png diff --git a/app/doc/png.d/dcurve1.png b/app/doc/png.d/dcurve1.png Binary files differindex c0ca63b..66361ba 100644 --- a/app/doc/png.d/dcurve1.png +++ b/app/doc/png.d/dcurve1.png diff --git a/app/doc/png.d/dcurve2.png b/app/doc/png.d/dcurve2.png Binary files differindex 7a4f75d..9c6a21d 100644 --- a/app/doc/png.d/dcurve2.png +++ b/app/doc/png.d/dcurve2.png diff --git a/app/doc/png.d/dcurve3.png b/app/doc/png.d/dcurve3.png Binary files differindex a68aebf..fea2ba3 100644 --- a/app/doc/png.d/dcurve3.png +++ b/app/doc/png.d/dcurve3.png diff --git a/app/doc/png.d/dcurve4.png b/app/doc/png.d/dcurve4.png Binary files differindex d337fa1..408a308 100644 --- a/app/doc/png.d/dcurve4.png +++ b/app/doc/png.d/dcurve4.png diff --git a/app/doc/png.d/ddimlin.png b/app/doc/png.d/ddimlin.png Binary files differindex adc471d..49d9488 100644 --- a/app/doc/png.d/ddimlin.png +++ b/app/doc/png.d/ddimlin.png diff --git a/app/doc/png.d/dentermove.png b/app/doc/png.d/dentermove.png Binary files differnew file mode 100644 index 0000000..1ec8b34 --- /dev/null +++ b/app/doc/png.d/dentermove.png diff --git a/app/doc/png.d/dfilbox.png b/app/doc/png.d/dfilbox.png Binary files differindex 4e75f0b..d20421c 100644 --- a/app/doc/png.d/dfilbox.png +++ b/app/doc/png.d/dfilbox.png diff --git a/app/doc/png.d/dfilpoly.png b/app/doc/png.d/dfilpoly.png Binary files differindex 36893ad..d714dab 100644 --- a/app/doc/png.d/dfilpoly.png +++ b/app/doc/png.d/dfilpoly.png diff --git a/app/doc/png.d/dflcrcl2.png b/app/doc/png.d/dflcrcl2.png Binary files differindex cd57434..0e9e1f7 100644 --- a/app/doc/png.d/dflcrcl2.png +++ b/app/doc/png.d/dflcrcl2.png diff --git a/app/doc/png.d/dflcrcl3.png b/app/doc/png.d/dflcrcl3.png Binary files differindex 34942cd..c702428 100644 --- a/app/doc/png.d/dflcrcl3.png +++ b/app/doc/png.d/dflcrcl3.png diff --git a/app/doc/png.d/displayopt.png b/app/doc/png.d/displayopt.png Binary files differindex be769a1..cf0178a 100644 --- a/app/doc/png.d/displayopt.png +++ b/app/doc/png.d/displayopt.png diff --git a/app/doc/png.d/dlayer.png b/app/doc/png.d/dlayer.png Binary files differdeleted file mode 100644 index ebb5be7..0000000 --- a/app/doc/png.d/dlayer.png +++ /dev/null diff --git a/app/doc/png.d/dlayers.png b/app/doc/png.d/dlayers.png Binary files differindex a965062..200ef81 100644 --- a/app/doc/png.d/dlayers.png +++ b/app/doc/png.d/dlayers.png diff --git a/app/doc/png.d/dline.png b/app/doc/png.d/dline.png Binary files differindex 11ad69f..2f4c996 100644 --- a/app/doc/png.d/dline.png +++ b/app/doc/png.d/dline.png diff --git a/app/doc/png.d/dpoly.png b/app/doc/png.d/dpoly.png Binary files differindex 7998634..577983e 100644 --- a/app/doc/png.d/dpoly.png +++ b/app/doc/png.d/dpoly.png diff --git a/app/doc/png.d/dpolylin.png b/app/doc/png.d/dpolylin.png Binary files differnew file mode 100644 index 0000000..d66cd2b --- /dev/null +++ b/app/doc/png.d/dpolylin.png diff --git a/app/doc/png.d/dprmfile.png b/app/doc/png.d/dprmfile.png Binary files differindex 7733a1c..ba5170a 100644 --- a/app/doc/png.d/dprmfile.png +++ b/app/doc/png.d/dprmfile.png diff --git a/app/doc/png.d/dtbledge.png b/app/doc/png.d/dtbledge.png Binary files differindex 52eb1ed..3f8e019 100644 --- a/app/doc/png.d/dtbledge.png +++ b/app/doc/png.d/dtbledge.png diff --git a/app/doc/png.d/exportfile.png b/app/doc/png.d/exportfile.png Binary files differindex 0608fba..a6132a8 100644 --- a/app/doc/png.d/exportfile.png +++ b/app/doc/png.d/exportfile.png diff --git a/app/doc/png.d/exportfiledxf.png b/app/doc/png.d/exportfiledxf.png Binary files differindex 7612fba..9b6dbf0 100644 --- a/app/doc/png.d/exportfiledxf.png +++ b/app/doc/png.d/exportfiledxf.png diff --git a/app/doc/png.d/exportfilesvg.png b/app/doc/png.d/exportfilesvg.png Binary files differnew file mode 100644 index 0000000..89d3919 --- /dev/null +++ b/app/doc/png.d/exportfilesvg.png diff --git a/app/doc/png.d/iconlink.PNG b/app/doc/png.d/iconlink.png Binary files differindex 0f189e2..0f189e2 100644 --- a/app/doc/png.d/iconlink.PNG +++ b/app/doc/png.d/iconlink.png diff --git a/app/doc/png.d/import.png b/app/doc/png.d/import.png Binary files differindex e68363e..3dfeb4b 100644 --- a/app/doc/png.d/import.png +++ b/app/doc/png.d/import.png diff --git a/app/doc/png.d/importmod.png b/app/doc/png.d/importmod.png Binary files differnew file mode 100644 index 0000000..64b2807 --- /dev/null +++ b/app/doc/png.d/importmod.png diff --git a/app/doc/png.d/layout.png b/app/doc/png.d/layout.png Binary files differindex d5607da..54f35c9 100644 --- a/app/doc/png.d/layout.png +++ b/app/doc/png.d/layout.png diff --git a/app/doc/png.d/madd.png b/app/doc/png.d/madd.png Binary files differindex e8a664f..bde4a7f 100644 --- a/app/doc/png.d/madd.png +++ b/app/doc/png.d/madd.png diff --git a/app/doc/png.d/maddcircle.png b/app/doc/png.d/maddcircle.png Binary files differnew file mode 100644 index 0000000..57708a1 --- /dev/null +++ b/app/doc/png.d/maddcircle.png diff --git a/app/doc/png.d/maddcontrol.png b/app/doc/png.d/maddcontrol.png Binary files differnew file mode 100644 index 0000000..0a0e167 --- /dev/null +++ b/app/doc/png.d/maddcontrol.png diff --git a/app/doc/png.d/maddcurve.png b/app/doc/png.d/maddcurve.png Binary files differnew file mode 100644 index 0000000..7b63b71 --- /dev/null +++ b/app/doc/png.d/maddcurve.png diff --git a/app/doc/png.d/maddparallel.png b/app/doc/png.d/maddparallel.png Binary files differnew file mode 100644 index 0000000..c821f4a --- /dev/null +++ b/app/doc/png.d/maddparallel.png diff --git a/app/doc/png.d/map.png b/app/doc/png.d/map.png Binary files differindex 6400bf1..e784dfa 100644 --- a/app/doc/png.d/map.png +++ b/app/doc/png.d/map.png diff --git a/app/doc/png.d/mchange.png b/app/doc/png.d/mchange.png Binary files differindex f891411..e09079c 100644 --- a/app/doc/png.d/mchange.png +++ b/app/doc/png.d/mchange.png diff --git a/app/doc/png.d/mconvert.png b/app/doc/png.d/mconvert.png Binary files differnew file mode 100644 index 0000000..879777d --- /dev/null +++ b/app/doc/png.d/mconvert.png diff --git a/app/doc/png.d/mdraw.png b/app/doc/png.d/mdraw.png Binary files differindex 46b1f69..24d46ce 100644 --- a/app/doc/png.d/mdraw.png +++ b/app/doc/png.d/mdraw.png diff --git a/app/doc/png.d/mdrawcircles.png b/app/doc/png.d/mdrawcircles.png Binary files differindex 30f9f00..42e1854 100644 --- a/app/doc/png.d/mdrawcircles.png +++ b/app/doc/png.d/mdrawcircles.png diff --git a/app/doc/png.d/mdrawcurve.png b/app/doc/png.d/mdrawcurve.png Binary files differindex 20501f0..6a638c3 100644 --- a/app/doc/png.d/mdrawcurve.png +++ b/app/doc/png.d/mdrawcurve.png diff --git a/app/doc/png.d/mdrawmeasure.png b/app/doc/png.d/mdrawmeasure.png Binary files differnew file mode 100644 index 0000000..e090704 --- /dev/null +++ b/app/doc/png.d/mdrawmeasure.png diff --git a/app/doc/png.d/mdrawnotes.png b/app/doc/png.d/mdrawnotes.png Binary files differnew file mode 100644 index 0000000..2b0a128 --- /dev/null +++ b/app/doc/png.d/mdrawnotes.png diff --git a/app/doc/png.d/mdrawshapes.png b/app/doc/png.d/mdrawshapes.png Binary files differindex d7a8a30..7d81c96 100644 --- a/app/doc/png.d/mdrawshapes.png +++ b/app/doc/png.d/mdrawshapes.png diff --git a/app/doc/png.d/mdrawstraight.png b/app/doc/png.d/mdrawstraight.png Binary files differindex c0767a3..dbf4363 100644 --- a/app/doc/png.d/mdrawstraight.png +++ b/app/doc/png.d/mdrawstraight.png diff --git a/app/doc/png.d/medit.png b/app/doc/png.d/medit.png Binary files differindex 3b69b83..ccb7858 100644 --- a/app/doc/png.d/medit.png +++ b/app/doc/png.d/medit.png diff --git a/app/doc/png.d/mentermove.png b/app/doc/png.d/mentermove.png Binary files differnew file mode 100644 index 0000000..42dcb54 --- /dev/null +++ b/app/doc/png.d/mentermove.png diff --git a/app/doc/png.d/mfile.png b/app/doc/png.d/mfile.png Binary files differindex 4bbd678..3318d9e 100644 --- a/app/doc/png.d/mfile.png +++ b/app/doc/png.d/mfile.png diff --git a/app/doc/png.d/mhelp.png b/app/doc/png.d/mhelp.png Binary files differindex e06e37d..512677b 100644 --- a/app/doc/png.d/mhelp.png +++ b/app/doc/png.d/mhelp.png diff --git a/app/doc/png.d/mhelpdemos.png b/app/doc/png.d/mhelpdemos.png Binary files differindex 1b935bc..f67ee8e 100644 --- a/app/doc/png.d/mhelpdemos.png +++ b/app/doc/png.d/mhelpdemos.png diff --git a/app/doc/png.d/mjoin.png b/app/doc/png.d/mjoin.png Binary files differnew file mode 100644 index 0000000..29034d6 --- /dev/null +++ b/app/doc/png.d/mjoin.png diff --git a/app/doc/png.d/mmacro.png b/app/doc/png.d/mmacro.png Binary files differindex 4bb4203..b88580f 100644 --- a/app/doc/png.d/mmacro.png +++ b/app/doc/png.d/mmacro.png diff --git a/app/doc/png.d/mmanage.png b/app/doc/png.d/mmanage.png Binary files differindex 8ea36f7..34647cc 100644 --- a/app/doc/png.d/mmanage.png +++ b/app/doc/png.d/mmanage.png diff --git a/app/doc/png.d/mmanageturnoutdesign.png b/app/doc/png.d/mmanageturnoutdesign.png Binary files differindex 9a1fbec..9473414 100644 --- a/app/doc/png.d/mmanageturnoutdesign.png +++ b/app/doc/png.d/mmanageturnoutdesign.png diff --git a/app/doc/png.d/moptions.png b/app/doc/png.d/moptions.png Binary files differindex 3548abf..c8dbeb5 100644 --- a/app/doc/png.d/moptions.png +++ b/app/doc/png.d/moptions.png diff --git a/app/doc/png.d/mselect.png b/app/doc/png.d/mselect.png Binary files differdeleted file mode 100644 index 3d0f78a..0000000 --- a/app/doc/png.d/mselect.png +++ /dev/null diff --git a/app/doc/png.d/mselectcmd.png b/app/doc/png.d/mselectcmd.png Binary files differnew file mode 100644 index 0000000..07a4c20 --- /dev/null +++ b/app/doc/png.d/mselectcmd.png diff --git a/app/doc/png.d/mselectcontext.png b/app/doc/png.d/mselectcontext.png Binary files differnew file mode 100644 index 0000000..fe6a34c --- /dev/null +++ b/app/doc/png.d/mselectcontext.png diff --git a/app/doc/png.d/mselected.png b/app/doc/png.d/mselected.png Binary files differdeleted file mode 100644 index c6ac4a3..0000000 --- a/app/doc/png.d/mselected.png +++ /dev/null diff --git a/app/doc/png.d/mselectedcontext.png b/app/doc/png.d/mselectedcontext.png Binary files differnew file mode 100644 index 0000000..607398f --- /dev/null +++ b/app/doc/png.d/mselectedcontext.png diff --git a/app/doc/png.d/msplit.png b/app/doc/png.d/msplit.png Binary files differnew file mode 100644 index 0000000..2fe2d48 --- /dev/null +++ b/app/doc/png.d/msplit.png diff --git a/app/doc/png.d/mview.png b/app/doc/png.d/mview.png Binary files differindex 7bf2037..61fff8c 100644 --- a/app/doc/png.d/mview.png +++ b/app/doc/png.d/mview.png diff --git a/app/doc/png.d/pan.png b/app/doc/png.d/pan.png Binary files differindex 653ee4d..d4ebd72 100644 --- a/app/doc/png.d/pan.png +++ b/app/doc/png.d/pan.png diff --git a/app/doc/png.d/paramsearch.png b/app/doc/png.d/paramsearch.png Binary files differindex ec6b2b8..67db04b 100644 --- a/app/doc/png.d/paramsearch.png +++ b/app/doc/png.d/paramsearch.png diff --git a/app/doc/png.d/pref.png b/app/doc/png.d/pref.png Binary files differindex e72b459..57940a6 100644 --- a/app/doc/png.d/pref.png +++ b/app/doc/png.d/pref.png diff --git a/app/doc/png.d/problemdata.png b/app/doc/png.d/problemdata.png Binary files differnew file mode 100644 index 0000000..fccde93 --- /dev/null +++ b/app/doc/png.d/problemdata.png diff --git a/app/doc/png.d/statusbarparallel.png b/app/doc/png.d/statusbarparallel.png Binary files differindex 0ab73a5..f55e596 100644 --- a/app/doc/png.d/statusbarparallel.png +++ b/app/doc/png.d/statusbarparallel.png diff --git a/app/doc/png.d/statustext.png b/app/doc/png.d/statustext.png Binary files differindex 6435000..dfa20ae 100644 --- a/app/doc/png.d/statustext.png +++ b/app/doc/png.d/statustext.png diff --git a/app/doc/png.d/sticky.png b/app/doc/png.d/sticky.png Binary files differindex fbc2316..2683cce 100644 --- a/app/doc/png.d/sticky.png +++ b/app/doc/png.d/sticky.png diff --git a/app/doc/png.d/turnsel.png b/app/doc/png.d/turnsel.png Binary files differindex b2e1b6d..60d8ff3 100644 --- a/app/doc/png.d/turnsel.png +++ b/app/doc/png.d/turnsel.png diff --git a/app/doc/view_winm.but b/app/doc/view_winm.but index cb115a9..ac853e4 100644 --- a/app/doc/view_winm.but +++ b/app/doc/view_winm.but @@ -26,15 +26,15 @@ The \f{View Menu} shows commands affecting the display of the \f{Main Canvas} (\ \u000 -\dd \f{Show Snap-Grid} - Toggles display of the \f{Snap Grid} on and off. +\dd \f{Show Snap-Grid} - \I{Snap Grid} Toggles display of the \f{Snap Grid} on and off. \u000 -\dd \f{Magnetic Snap On/Off} - Toggles Magnets for Add Operations on and off. The magnets make tracks auto-align and shapes touch when the cursor or object is close. They can be defeated on each operation by holding down \e{Alt}. If the Magnets are off, holding down \e{Alt} will enable them. +\dd \f{Magnetic Snap On/Off} - Toggles \i{Magnetic Snap} (\K{cmdMagneticSnap}) for Add Operations on and off. The magnets make tracks auto-align and shapes touch when the cursor or object is close. They can be defeated on each operation by holding down \e{Alt}. If the Magnets are off, holding down \e{Alt} will enable them. \u000 -\dd \G{png.d/bmap.png} \f{ Show/Hide Map} - Toggles display of the \f{Map Window} on and off. +\dd \G{png.d/bmap.png} \f{ Show/Hide Map} - Toggles display of the \f{Map Window} \I{Map Window} on and off. \u000 @@ -42,6 +42,10 @@ The \f{View Menu} shows commands affecting the display of the \f{Main Canvas} (\ \u000 +\dd \f{Pan/Zoom} - move or resize the viewport using the mouse (\K{cmdPan}). + +\u000 + \dd \G{png.d/mzoomscale.png} \u000 @@ -62,15 +66,34 @@ When zooming in or out, the corresponding highlighted area of the \f{Map Window} \rule -\S{cmdGrid} Grid Dialog +\S{cmdMagneticSnap} Magnetic Snap + +The \f{MagneticSnap} feature eases constructing and assembling Tracks and Draw objects by "snapping" the end of new objects to existing objects. +For existing track objects the point snapped to is always an open end point. +The snap operates when "close" to the object (a few pixels distant) and an anchor point (a blue circle) is displayed when this will occur if the mouse is clicked. + +\u000 +When Adding Draw line objects, the snap point is the nearest point on the existing object. +A snap to the end of a line object can be selected by positioning the cursor close to the end of the line but off it, in the direction of the line. This will ensure the closest point is the end. + +\u000 +The \f{MagneticSnap} feature is enabled and disabled using either the magnet icon which is part of the \f{SnapGrid} Toolbar button set, or using the View (\K{viewM}) menu. + +For each part of an Add or Move or Rotate operation, the current state of \f{MagneticSnap} can be temporarily inverted using the \f{Alt} key. +This enables snapping to be inhibited for a single part of an operation (or conversely enabled for just one part). + +\rule -The \f{Grid} dialog, displayed by \f{Change Grid} on the View (\K{viewM}) menu, specifies the origin, angle and other parameters of the Snap Grid. The Snap Grid controls the position of the cursor during the \f{Curve} (\K{cmdCurve}), \f{Circle} (\K{cmdCircle}), \f{Modify} (\K{cmdModify}), \f{Straight} (\K{cmdStraight}), \f{Line Drawing} (\K{cmdDraw}) and \f{Turntable} (\K{cmdTurntable}) commands. +\S{cmdGrid} \i{Grid Dialog} + +The \f{Grid} dialog, displayed by \f{Change Grid} on the View (\K{viewM}) menu, specifies the origin, angle and other parameters of the Snap Grid. +The Snap Grid can sbe used to snap the position of the cursor during the \f{Curve} (\K{cmdCurve}), \f{Circle} (\K{cmdCircle}), \f{Cornu} (\K{cmdCornu}), \f{Modify} (\K{cmdModify}), \f{Straight} (\K{cmdStraight}), \f{Draw} (\K{cmdDraw}) and \f{Turntable} (\K{cmdTurntable}) commands. \G{png.d/grid.png} The \f{Grid} dialog contains controls affecting the horizontal and vertical snap grid lines. Each dimension can be independently controlled. -\dd The \f{Spacing} value specifies the distance between major grid lines, which are drawn as solid lines on the layout. +\dd The \f{Spacing} value specifies the distance between major grid lines, which are drawn as solid lines on the layout. The value of the distance is entered in either inches or centimeters depending on the value of the \f{Units} setting in Options->Preferencecs (\K{cmdPref}) menu. \u000 @@ -78,7 +101,7 @@ The \f{Grid} dialog contains controls affecting the horizontal and vertical snap \u000 -\dd The Grid can be enabled or disabled in each dimension via the \f{Enable} check box. +\dd The Grid can be enabled or disabled in each dimension via the \f{Enable} check box. The action of snapping is secondary to \f{Magnetic Snap} if enabled, and is suppressed if \f{Alt} is held. \u000 @@ -102,7 +125,7 @@ Whether the Snap Grid is drawn is controlled by the \f{Show} check-box. Also, i \rule -\S{toolbarM}Tool-bar Configuration +\S{toolbarM} \I{Tool-bar Configuration} \G{png.d/mtoolbar.png} @@ -110,7 +133,6 @@ Command button groups displayed on the \f{Tool-bar} are selected using the Tool- \rule - \S{cmdZoom} \i{Zoom} \G{png.d/bgzoom.png} @@ -133,6 +155,10 @@ Holding down the Shift key while clicking the \f{Zoom In} or \f{Zoom Out} button \u000 +\b Key 's' sets the zoom to show the selected set of objects and pans the window to center the highlit area. + +\u000 + \b Key '0' or 'o' keeps the zoom as is, but moves the origin of the bottom left of the window to 0,0 \u000 @@ -147,8 +173,11 @@ Pressing the middle Zoom button on the Tool Bar pop-ups a list of Zoom factors t \u000 -\dd The Pan function can be accessed using the Mouse Wheel with \e{Shift} of the \e{Mouse Middle Button}. Adding \e{Ctrl} as well as \e{Shift} chnages Up to Left and Down to Right. -Pan Left and Right can also be driven by the Horizontal Mouse Wheel (if available) or the Scroll Left/Right Guestures (if mapped by the Operating System). +\e{Note} - The value of Zoom 1:1 will be set using 96 dpi as a default, it can be overriden using a Configuration Value in the Preferences section of ScreenDPI. + +\u000 + +\dd See \f{Main Window Overview} (\K{mainW}) for details on how to \f{Pan} the \f{Main Canvas}. \rule @@ -169,4 +198,4 @@ The \f{Window Menu} typically contains selections for bringing any open window i \dd Apart from bringing the \f{Map Window} (\K{cmdMap}) to the foreground, the \f{Map} menu item can also be used to re-opened a closed \f{Map Window}. -\rule
\ No newline at end of file +\rule diff --git a/app/doc/warranty.but b/app/doc/warranty.but index 357a0cb..7502c38 100644 --- a/app/doc/warranty.but +++ b/app/doc/warranty.but @@ -10,7 +10,7 @@ covered by the Creative Commons Attribution-ShareAlike 2.5 License Agreement. \rule -\H{warranty} Warranty +\H{warranty} \i{Warranty} \e{XTrackCAD} is provided "as is" without warranty of any kind, either express or implied, including, but not limited to warranties of merchantability or fitness for a particular purpose. In no event will Sillub Technology be liable for any damages, including incidental or consequential damages, arising out of the use of the program, even if advised of the possibility of such damages. @@ -24,14 +24,14 @@ covered by the Creative Commons Attribution-ShareAlike 2.5 License Agreement. \e{XTrackCAD} is \XTCCopyRight and licensed as free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. -You should have received a copy of the GNU General Public License along with this program; see the file named COPYING or refer to \K{GNUGPLicense}. If not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA +You should have received a copy of the GNU General Public License along with this program; see the file named COPYING or refer to \K{GNUGPLicense}. If not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA \e{XTrackCAD} Fork is a project for further development of the original \e{XTrackCAD} software. Refer to the project homepage at http://www.xtrkcad.org/ for news and current releases. \rule -\H{GNUGPLicense} \ii{GNU General Public License} +\H{GNUGPLicense} \ii{GNU General Public License} \i{License} \dd GNU GENERAL PUBLIC LICENSE @@ -41,13 +41,13 @@ You should have received a copy of the GNU General Public License along with thi \dd Copyright (C) 1989, 1991 Free Software Foundation, Inc. -\dd 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA +\dd 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed. \e{Preamble} -The licenses for most software are designed to take away your freedom to share and change it. By contrast, the GNU General Public License is intended to guarantee your freedom to share and change free software--to make sure the software is free for all its users. This General Public License applies to most of the Free Software Foundation's software and to any other program whose authors commit to using it. (Some other Free Software Foundation software is covered by the GNU Library General Public License instead.) You can apply it to +The licenses for most software are designed to take away your freedom to share and change it. By contrast, the GNU General Public License is intended to guarantee your freedom to share and change free software--to make sure the software is free for all its users. This General Public License applies to most of the Free Software Foundation's software and to any other program whose authors commit to using it. (Some other Free Software Foundation software is covered by the GNU Lesser General Public License instead.) You can apply it to your programs, too. When we speak of free software, we are referring to freedom, not price. Our General Public Licenses are designed to make sure that you have the freedom to distribute copies of free software (and charge for this service if you wish), that you receive source code or can get it @@ -149,4 +149,136 @@ MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE \f{END OF TERMS AND CONDITIONS} +\f{How to Apply These Terms to Your New Programs} + +If you develop a new program, and you want it to be of the greatest +possible use to the public, the best way to achieve this is to make it +free software which everyone can redistribute and change under these terms. + +To do so, attach the following notices to the program. It is safest +to attach them to the start of each source file to most effectively +convey the exclusion of warranty; and each file should have at least +the "copyright" line and a pointer to where the full notice is found. + +\dd <one line to give the program's name and a brief idea of what it does.> Copyright (C) <year> <name of author> + +\u000 + +\dd This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. + +\u000 + +\dd This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. + +\u000 + +\dd You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. + +Also add information on how to contact you by electronic and paper mail. + +If the program is interactive, make it output a short notice like this +when it starts in an interactive mode: + +\dd Gnomovision version 69, Copyright (C) year name of author Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'. This is free software, and you are welcome to redistribute it under certain conditions; type `show c' for details. + +The hypothetical commands `show w' and `show c' should show the appropriate +parts of the General Public License. Of course, the commands you use may +be called something other than `show w' and `show c'; they could even be +mouse-clicks or menu items--whatever suits your program. + +You should also get your employer (if you work as a programmer) or your +school, if any, to sign a "copyright disclaimer" for the program, if +necessary. Here is a sample; alter the names: + +\dd Yoyodyne, Inc., hereby disclaims all copyright interest in the program + `Gnomovision' (which makes passes at compilers) written by James Hacker. + +\u000 + +\dd <signature of Ty Coon>, 1 April 1989 + +\u000 + +\dd Ty Coon, President of Vice + +This General Public License does not permit incorporating your program into +proprietary programs. If your program is a subroutine library, you may +consider it more useful to permit linking proprietary applications with the +library. If this is what you want to do, use the GNU Lesser General +Public License instead of this License. + \rule + +\H{Contributions} \ii{Contributions} + +XTrackCAD incorporates the following software: + +\c This program uses FreeImage, a free, open source image library supporting all common bitmap formats. +\e bbbbbbbbb +\c See http://freeimage.sourceforge.net for details + +\u000 + +\c uthash, utlist +\e bbbbbb bbbbbb +\c Copyright (c) 2005-2015, Troy D. Hanson http://troydhanson.github.com/uthash/ +\c All rights reserved. + +\u000 + +\c CJson - https://github.com/DaveGamble/cJSON/blob/master/README.md#license +\e bbbbb +\c Copyright (c) 2009-2017 Dave Gamble and cJSON contributors + +\u000 + +\c zlib - https://opensource.org/licenses/zlib-license.php +\e bbbb + +\u000 + +\c libzip - https://libzip.org/license/ +\e bbbbbb +\c Copyright (C) 1999-2019 Dieter Baron and Thomas Klausner + +\c The authors can be contacted at <libzip@nih.at> + +\c Redistribution and use in source and binary forms, with or without +\c modification, are permitted provided that the following conditions +\c are met: + +\c 1. Redistributions of source code must retain the above copyright +\c notice, this list of conditions and the following disclaimer. + +\c 2. Redistributions in binary form must reproduce the above copyright +\c notice, this list of conditions and the following disclaimer in +\c the documentation and/or other materials provided with the +\c distribution. + +\c 3. The names of the authors may not be used to endorse or promote +\c products derived from this software without specific prior +\c written permission. + +\c THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS +\c OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED +\c WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +\c ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY +\c DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +\c DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE +\c GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS +\c INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER +\c IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR +\c OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN +\c IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + +\u000 + +\c minixml - https://github.com/michaelrsweet/mxml/commit/f166ad1977f2f13295689772a5d9e442f73d46f1 +\e bbbbbbb + +\c Copyright (C) 2003-2019 by Michael R Sweet. +\c The Mini-XML library is licensed under the Apache License Version 2.0 with an +\c exception to allow linking against GPL2/LGPL2-only software. + + + diff --git a/app/doc/xtrkcad-manual-5.3.0.html b/app/doc/xtrkcad-manual-5.3.0.html new file mode 100644 index 0000000..da1d2cf --- /dev/null +++ b/app/doc/xtrkcad-manual-5.3.0.html @@ -0,0 +1,19625 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>XTrackCAD User's Manual</title> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="index.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><em>XTrackCAD</em> User's Manual</h1> +<p> +<img src="png.d/xtrkcad_logo.gif"> +</p> +<p> +<em>Version 5.3.0GA</em> +</p> +<p> +Copyright 2003, Sillub Technology and Copyright 2007, Bob Blackwell and Martin Fischer and Copyright 2020, Martin Fischer, Adam Richards and Dave Bullis +</p> +<hr> +<ul> +<li><a href="index.html#index">Chapter 1: Introduction To <em>XTrackCAD</em></a></li> +<ul> +<li><a href="whyXTrackCAD.html#whyXTrackCAD">1.1 Why Choose <em>XTrackCAD</em></a></li> +<li><a href="keyFeatures.html#keyFeatures">1.2 Key <em>XTrackCAD</em> Features</a></li> +<li><a href="addFeatures.html#addFeatures">1.3 Additional <em>XTrackCAD</em> Features</a></li> +<li><a href="aboutmanual.html#aboutmanual">1.4 About This Manual</a></li> +<li><a href="installSoftware.html#installSoftware">1.5 Installation</a></li> +<li><a href="startSoftware.html#startSoftware">1.6 Start the Program</a></li> +<li><a href="introQT.html#introQT">1.7 Quick Tour</a></li> +<li><a href="performance.html#performance">1.8 Performance Issues</a></li> +<li><a href="directories.html#directories">1.9 Files and Directories</a></li> +<li><a href="uninstall.html#uninstall">1.10 Removing <em>XTrackCAD</em></a></li> +<li><a href="bugs_enhancements.html#bugs_enhancements">1.11 Bugs and Enhancements</a></li> +</ul> +<li><a href="commandMenus.html#commandMenus">Chapter 2: Command Menus</a></li> +<ul> +<li><a href="addM.html#addM">2.1 Add Menu</a></li> +<li><a href="changeM.html#changeM">2.2 Change Menu</a></li> +<li><a href="cmdDraw.html#cmdDraw">2.3 Draw Menu</a></li> +<li><a href="editM.html#editM">2.4 Edit Menu</a></li> +<li><a href="fileM.html#fileM">2.5 File Menu</a></li> +<li><a href="helpM.html#helpM">2.6 Help Menu</a></li> +<li><a href="cmdHotBar.html#cmdHotBar">2.7 Hot Bar</a></li> +<li><a href="macroM.html#macroM">2.8 Macro Menu</a></li> +<li><a href="manageM.html#manageM">2.9 Manage Menu</a></li> +<li><a href="optionM.html#optionM">2.10 Options Menu</a></li> +<li><a href="cmdStatusbar.html#cmdStatusbar">2.11 Status Bar</a></li> +<li><a href="viewM.html#viewM">2.12 View Menu</a></li> +<li><a href="windowM.html#windowM">2.13 Window Menu</a></li> +</ul> +<li><a href="navigation.html#navigation">Chapter 3: Navigation</a></li> +<ul> +<li><a href="mainW.html#mainW">3.1 Main Window Overview</a></li> +<li><a href="generaloperation.html#generaloperation">3.2 General Operation </a></li> +<li><a href="kbshortcuts.html#kbshortcuts">3.3 Keyboard Shortcuts </a></li> +<li><a href="cmdAcclKeys.html#cmdAcclKeys">3.4 Mouse Actions</a></li> +</ul> +<li><a href="faqs.html#faqs">Appendix A: Frequently Asked Questions</a></li> +<ul> +<li><a href="faqsTransfer.html#faqsTransfer">A.1 Moving from Design to Roadbed </a></li> +<li><a href="faqsHotBar.html#faqsHotBar">A.2 Hot Bar Items Missing!</a></li> +<li><a href="faqsPrototype.html#faqsPrototype">A.3 Unable to Add Cars to Inventory!</a></li> +<li><a href="faqsJoin.html#faqsJoin">A.4 How Do I Place and Join Tracks</a></li> +</ul> +<li><a href="glossary.html#glossary">Appendix B: Glossary</a></li> +<ul> +<li><a href="windowTerms.html#windowTerms">B.1 Window Terms</a></li> +<li><a href="generalTerms.html#generalTerms">B.2 XTrackCAD Terms</a></li> +<li><a href="controlElementScripts.html#controlElementScripts">B.3 Control Element Scripts and the Model RR System's Dispatcher</a></li> +</ul> +<li><a href="messages.html#messages">Appendix C: Messages and Explanations</a></li> +<ul> +<li><a href="messageType.html#messageType">C.1 Message Types</a></li> +<li><a href="messageList.html#messageList">C.2 Message Explanations</a></li> +</ul> +<li><a href="upgrades.html#upgrades">Appendix D: Upgrade From Earlier <em>XTrackCAD</em> Version</a></li> +<ul> +<li><a href="v5.html#v5">D.1 Version 5.x</a></li> +<li><a href="cmdUpdatetitle.html#cmdUpdatetitle">D.2 Version 2.x</a></li> +<li><a href="v4.0.3_revisions.html#v4.0.3_revisions">D.3 Version 4.0.3</a></li> +<li><a href="v4.0.x_revisions.html#v4.0.x_revisions">D.4 Version 4.0.x</a></li> +</ul> +<li><a href="warrantyLicenseCopy.html#warrantyLicenseCopy">Appendix E: Warranty, License and Copying</a></li> +<ul> +<li><a href="warranty.html#warranty">E.1 Warranty</a></li> +<li><a href="copydist.html#copydist">E.2 Copying and Distribution</a></li> +<li><a href="GNUGPLicense.html#GNUGPLicense">E.3 GNU General Public License License</a></li> +<li><a href="Contributions.html#Contributions">E.4 Contributions</a></li> +</ul> +<li><a href="IndexPage.html#Index">Index</a></li> +</ul> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Introduction To XTrackCAD</title> +<link rel="previous" href="contents.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="whyXTrackCAD.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"><meta name="AppleTitle" content="org.xtrkcad.help" /> +</head> +<body> +<h1><a name="index"></a>Chapter 1: Introduction To <em>XTrackCAD</em></h1> +<p> +<em>XTrackCAD</em> is a CAD (computer-aided design) program for designing Model Railroad layouts. <em>XTrackCAD</em> supports any scale, has libraries of popular brands of turnouts and sectional track (plus you add your own easily), can automatically use spiral transition curves when joining track and has extensive on-line help and demonstrations. <em>XTrackCAD</em> lets you manipulate track much like you would with actual flex-track to modify, extend and join tracks and turnouts. Additional features include tunnels, 'post-it' notes, on-screen ruler, parts list, 99 drawing layers, undo/redo commands, bench-work, 'Print to Bitmap', elevations, train simulation and car inventory. +</p> +<p> +Using it, you can +</p> +<ul><li> +Design layouts in any scale and gauge, +</li> +</ul> +<p> + +</p> +<ul><li> +Use predefined libraries for many popular brands of turnouts to help you get started easily, +</li> +</ul> +<p> + +</p> +<ul><li> +Add your own favorite components, +</li> +</ul> +<p> + +</p> +<ul><li> +Manipulate track much like you would with actual flex-track to modify, extend and join tracks and turnouts, +</li> +</ul> +<p> + +</p> +<ul><li> +Automatically generated Cornu <em>transition curves</em> (easements) whenever the track radius changes. +</li> +</ul> +<p> + +</p> +<ul><li> +Test your design by running trains, including picking them up and moving them with the mouse. +</li> +</ul> +<p> + +</p> +<ul><li> +Trace tracks and other objects over a background image of a real-world location map, a scanned trackplan, or other image. +</li> +</ul> +<p> + +</p> +<ul><li> +Print the design in a scale of your choice. When printed in 1:1 scale the printout can be used as a template for laying the track to build your dream layout. +</li> +</ul> +<p> + +</p> +<p> +New users should run the demonstrations (via the <strong>Help>Demos</strong> menu) to get an overview of the many features of the program. A number of example layout designs are also available. +</p> +<p> +Be sure to visit the project web page for latest news and updates: <a href="http://www.xtrkcad.org/" target="_blank"><em>XTrackCAD</em> Fork Website</a> +</p> +<hr> +<ul> +<li><a href="whyXTrackCAD.html#whyXTrackCAD">1.1 Why Choose <em>XTrackCAD</em></a></li> +<li><a href="keyFeatures.html#keyFeatures">1.2 Key <em>XTrackCAD</em> Features</a></li> +<li><a href="addFeatures.html#addFeatures">1.3 Additional <em>XTrackCAD</em> Features</a></li> +<li><a href="aboutmanual.html#aboutmanual">1.4 About This Manual</a></li> +<li><a href="installSoftware.html#installSoftware">1.5 Installation</a></li> +<ul> +<li><a href="MSWinInstall.html#MSWinInstall">1.5.1 Microsoft Windows Installation</a></li> +<li><a href="OSXInstall.html#OSXInstall">1.5.2 OSX Installation Mac Installation</a></li> +<li><a href="LinuxInstall.html#LinuxInstall">1.5.3 Linux Installation</a></li> +</ul> +<li><a href="startSoftware.html#startSoftware">1.6 Start the Program</a></li> +<li><a href="introQT.html#introQT">1.7 Quick Tour</a></li> +<li><a href="performance.html#performance">1.8 Performance Issues</a></li> +<li><a href="directories.html#directories">1.9 Files and Directories</a></li> +<ul> +<li><a href="dirOverview.html#dirOverview">1.9.1 Directories Overview</a></li> +<li><a href="installDir.html#installDir">1.9.2 Install Directory</a></li> +<li><a href="workDir.html#workDir">1.9.3 Working Directory</a></li> +</ul> +<li><a href="uninstall.html#uninstall">1.10 Removing <em>XTrackCAD</em></a></li> +<li><a href="bugs_enhancements.html#bugs_enhancements">1.11 Bugs and Enhancements</a></li> +<ul> +<li><a href="bugs.html#bugs">1.11.1 Reporting Bugs</a></li> +<li><a href="enhancements.html#enhancements">1.11.2 Enhancement Requests</a></li> +<li><a href="support.html#support">1.11.3 User Support</a></li> +</ul> +</ul> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Why Choose XTrackCAD</title> +<link rel="previous" href="index.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="keyFeatures.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="whyXTrackCAD"></a>1.1 Why Choose <em>XTrackCAD</em></h1> +<p> +<strong>Why Choose XTrackCAD</strong> +</p> +<p> +<strong>Easy to use</strong> +</p> +<p> +<em>XTrackCAD</em> was designed to operate in a similar way to pencil and paper: You can draw tracks by dragging the mouse, you select and place turnout "templates" anywhere on existing tracks, and you can use fixed radii for initial design. +</p> +<p> +But extra capabilities have been added that give more power by using Flex-tracks (Cornu) you have tracks that automatically redraw as you drag turnouts around, creating smooth curves, you can zoom in and out, and of course, undo and deleting tracks are easier! +</p> +<p> +You don't have to be an expert CAD user to make the most of <em>XTrackCAD</em> but the program will ensure that dimensions, radii and angles are accurate. +</p> +<p> +You don't have to specify line lengths or angles and just draw. But if you want to be more precise, you can enter precise dimensions both in real-world and scale sizes. +</p> +<p> +<em>XTrackCAD</em> is a specialized CAD for railway modelling, it deals with tracks as tracks, not as line segments. Tracks are connected correctly to each other and with endpoints of turnouts and other components. +</p> +<p> +As you zoom in, the two rails are drawn and then ties are added. +</p> +<p> +<strong>Free</strong> +</p> +<p> +Thanks to the generosity of Dave Bullis, who wrote the progam, and the active help of open-source volunteers, XTrackCAD is free to own and use. You can even take up the cudgels and help! +</p> +<p> +<strong>Available Help</strong> +</p> +<p> +On-line demonstrations show the actual operation of many of the program's features. Extensive help is available for all commands and operations. There are communities of users and developers who can answer quaestions. +</p> +<p> +<strong>Packed with features</strong> +</p> +<p> +<em>XTrackCAD</em> is designed from the ground up to be a complete tool for many aspects of Model Railroad layout design. +</p> +<dl><dt> +<em>Active UI Prompting</em> +</dt> +<dd> +As the mouse moves over the layout objects, a set of different anchors are shown to indicate what is possible in each command with each modifier key if clicked or double clicked at that location. +</dd> +</dl> +<p> + +</p> +<dl><dt> +<em>Train Simulation and Car Inventory</em> +</dt> +<dd> +Any number of Cars and Locomotives can be placed on your layout to check clearances, siding capacities and track layout. Trains can be animated to simulate operations and switching on your layout. +</dd> +</dl> +<p> + +</p> +<dl><dd> +The Car Inventory dialog records your cars and locomotives and these can be exported and imported from spreadsheets. +</dd> +</dl> +<p> + +</p> +<dl><dt> +<em>Track Manipulation</em> +</dt> +<dd> +Track segments can be lengthened or shortened by simple click and drag. Tangents to a curve are created by dragging away from the curve. Tracks are extended by dragging from an Endpoint, creating new straight or curved segments. New tracks can be snapped into place or precisely placed and then Joined. +</dd> +</dl> +<p> + +</p> +<dl><dd> +Track circles are especially handy for determining overall designs and seeing what will fit in a given area. +</dd> +</dl> +<p> + +</p> +<dl><dd> +The Cornu flex-track features create dynamically variable tracks that optimise the curvature of tracks to ensure a protypical appearance. They alter as the other tracks are moved just as flex-track will in the 12 inches to the foot world! +</dd> +</dl> +<p> + +</p> +<dl><dd> +The Parallel command easily creates new straight or curved tracks, laying out yards and sidings in a few easy steps. Accurate platforms can be created with the Parallel Lines command followed by the Join Lines command. +</dd> +</dl> +<p> + +</p> +<dl><dd> +The Join command links any two tracks (Straights, Curves, Turnouts or Turntables) with accurate aligned connecting track segments which can be easements including Cornu easements. The connected tracks are trimmed or extended as required. +</dd> +</dl> +<p> + +</p> +<dl><dd> +The Helix Track command computes the number of turns, radius, grade and vertical separation based on your criteria. +</dd> +</dl> +<p> + +</p> +<dl><dd> +Turntables can be constructed with any radius and can either have fixed or dynamic bay tracks +</dd> +</dl> +<p> + +</p> +<dl><dt> +<em>Turnout Select and Placement</em> +</dt> +<dd> +The Turnout Hot Bar contains a scrolling list of Turnouts, Sectional Tracks and Structures available in the current Scale. Simply click on one and click again drop it onto the layout. +</dd> +</dl> +<p> + +</p> +<dl><dd> +As Turnouts are dragged over existing tracks they are automatically aligned. <em>XTrackCAD</em> searches for any other tracks that align with each of the Turnout's Endpoints, and shows you the number of connections that will be made and the maximum offset as you position the Turnout. Just adjust the Turnout's position to minimize the offset to ensure the best fit. +</dd> +</dl> +<p> + +</p> +<dl><dd> +When a turnout is placed, each Endpoint is examined to see if it aligned to an existing track. If so, the track is split to create a perfect connection to the turnout. Placing Turnouts is a 'snap'. +</dd> +</dl> +<p> + +</p> +<dl><dt> +<em>Layers</em> +</dt> +<dd> +Layers are an important feature for manageing the design for layouts of any complexity. Use one layer for the main-line and others for staging tracks, Bench-work or scenery. Multilevel designs can have groups of layers for each level. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<em>XTrackCAD</em> allows up to 99 layers layers can have their own button to control visibility. Each layer can have a name which is displayed as the balloon help for the layer button. +</dd> +</dl> +<p> + +</p> +<dl><dd> +Modular Layout assembly is supported with Modular Layers which ensure thier contents are moved as a set. +</dd> +</dl> +<p> + +</p> +<dl><dd> +Tracks and other objects can be colored according to which layer they are in. Also, each layer can be frozen to prevent accidental changes to parts of the layout that are finalized. +</dd> +</dl> +<p> + +</p> +<dl><dt> +<em>Elevations and Profile</em> +</dt> +<dd> +Elevations are one of the most powerful features of <em>XTrackCAD</em> they are dynamically recalulated as the layout changes. +</dd> +</dl> +<p> + +</p> +<dl><dd> +Traditional layout designs (such as published in magazines) show elevations at selected spots on the layout. They may also show grades between elevations. These can be input into XtrkCAD. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<em>XTrackCAD</em> lets you define the elevation of any Endpoint on the layout. You can also have <em>XTrackCAD</em> automatically compute the elevation and grade between defined elevation points. You can define the elevation at the bottom and top of a sloped track, then have <em>XTrackCAD</em> compute the elevation at each riser position between. +</dd> +</dl> +<p> + +</p> +<dl><dd> +Once you have defined a few elevations, you can display the Elevation Profile for the layout along a path of connected track segments. The Profile display shows the length of the track, the elevation of each defined elevation point and the grades between them. You can even adjust the elevations directly on the Profile display. +</dd> +</dl> +<p> + +</p> +<dl><dt> +<em>Easements (Cornu Transition Curves)</em> +</dt> +<dd> +Easements are special sections of gradually curving track used to connect straight and curved tracks (or two curved tracks). Easements reduce the effects of sudden changes in track curves which can cause derailments. They also look great! +</dd> +</dl> +<p> + +</p> +<dl><dd> +<em>XTrackCAD</em> can use Easements anytime the radius of the track changes. The Modify and Join commands will automatically insert Easement Track segments whenever needed. Each Easement is computed based on the radius of the neighboring tracks. You don't even have to think about it! +</dd> +</dl> +<p> + +</p> +<dl><dt> +<em>Flexible and Powerful Printing</em> +</dt> +<dd> +Printing is an important part of a layout design program, and <em>XTrackCAD</em> has a flexible Print command to get your design onto the layout. +</dd> +</dl> +<p> + +</p> +<dl><dd> +Printing is used for many purposes: +<ul><li> +A snapshot of the whole layout. +</li> +<li> +Detailed closeups to examine areas of complicated track work. +</li> +<li> +Full 1:1 for direct transfer to the layout. +</li> +</ul> + +</dd> +</dl> +<p> + +</p> +<dl><dd> +The Print command lets you scale the printout from a one page overall view (with the handy Snap-Shot button) right up to full size 1:1. +</dd> +</dl> +<p> + +</p> +<dl><dd> +Multiple page printouts are easy to do. A gird representing each page is drawn over the layout and you can click on the pages you want to print. The gird can be moved and rotated to any position so the orientation of the printout matches your layout. Pages can be printed in Portrait or Landscape format. +</dd> +</dl> +<p> + +</p> +<dl><dd> +At 1:1, registration marks can be printed every 3" (or 10cm) to help align different sets of printouts. Also, the roadbed outline can be drawn at a user-specified width to assist cutting the roadbed from sheet material. +</dd> +</dl> +<p> + +</p> +<dl><dt> +<em>Turnout and Structure Creation</em> +</dt> +<dd> +<em>XTrackCAD</em> comes with Turnout, Sectional Track and Structure Parameter Files for many brands of tracks and accessories. However, your brand may not supplied. The Turnout Designer dialogs and the Group command make it easy to add your own custom definitions. +</dd> +</dl> +<p> + +</p> +<dl><dd> +The Turnout Editor has separate screens for designing Turnouts (Regular, Curved, Wye and 3-way), Crossings, Slip-switch, Crossovers and Sectional Track. In each dialog a few measurements are required to create a new definition. Full size printouts can be made directly from the dialog to check your design. +</dd> +</dl> +<p> + +</p> +<dl><dd> +The Group command can create Structure definitions from selected tracks, lines and shapes. You can make structures as simple as a rectangle or highly detailed. You can also modify existing designs to add details or make adjustments. +</dd> +</dl> +<p> + +</p> +<dl><dt> +<em>Lines, Shapes, Table Edges, Text and Notes</em> +</dt> +<dd> +Layout designs are more than track! +</dd> +</dl> +<p> + +</p> +<dl><dd> +The <em>XTrackCAD</em> Draw command is used to draw lines (straight, curved and circles) and shapes (filled boxes, circles, polylines and polygons). These can be different colors and lines can have different widths. The Polylines and Polygons can have curved sides. These are useful for drawing scenic features (rivers, bridges, mountains). +</dd> +</dl> +<p> + +</p> +<dl><dd> +You can add Bench-work and dimension lines too. +</dd> +</dl> +<p> + +</p> +<dl><dd> +Special types of lines are drawn by the Table Edge command are used to represent the boundary at the edge of the layout. +</dd> +</dl> +<p> + +</p> +<dl><dd> +Text can be added to the layout. +</dd> +</dl> +<p> + +</p> +<dl><dd> +Notes can be attached to particular spots on the layout. When selected they can display special information about that part of the layout, such as prototype features, construction details or operation notes. This includes URL links to files on the Internet. +</dd> +</dl> +<p> + +</p> +<dl><dt> +<em>Parts and Price Lists</em> +</dt> +<dd> +The Parts List command generates a list of the number of the different types of Turnouts, Sectional Track and Structures selected on the layout. You can select everything or just the areas you are working on. As well, the total length of flex-track (for each track scale/gauge used on the layout) is listed. +</dd> +</dl> +<p> + +</p> +<dl><dd> +You can enter the price of each type of Turnout, Sectional Track and Structure, plus the length and price of flex-track. <em>XTrackCAD</em> will compute the price of each types and the grand total. The total number of flex-track sections is also listed. +</dd> +</dl> +<p> + +</p> +<dl><dt> +<em>Support for Sectional Track</em> +</dt> +<dd> +Numerous Sectional Track Parameter Files are included with <em>XTrackCAD</em> (Atlas, Marklin, Peco, ...). The Hot Bar allows easy selection. +</dd> +</dl> +<p> + +</p> +<dl><dd> +The automatic alignment feature of Turnout and Sectional Track placements makes track pieces just 'snap' together. +</dd> +</dl> +<p> + +</p> +<dl><dd> +The Connect Track command adjusts Sectional Track to smooth out the slight gaps that can arise when working with Sectional Track. +</dd> +</dl> +<p> + +</p> +<p> +Refer to <a href="keyFeatures.html#keyFeatures">Section 1.2</a> and <a href="addFeatures.html#addFeatures">Section 1.3</a> for a listing of <em>XTrackCAD</em> features. +</p> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Key XTrackCAD Features</title> +<link rel="previous" href="whyXTrackCAD.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="addFeatures.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="keyFeatures"></a>1.2 Key <em>XTrackCAD</em> Features</h1> +<ul><li> +Annotate with text and notes +</li> +</ul> +<p> + +</p> +<ul><li> +Automatic easement calculation +</li> +</ul> +<p> + +</p> +<ul><li> +Create Custom Designed Turnouts and Structures +</li> +</ul> +<p> + +</p> +<ul><li> +Create parallel straight and curved tracks +</li> +</ul> +<p> + +</p> +<ul><li> +Delete objects +</li> +</ul> +<p> + +</p> +<ul><li> +Describe objects +</li> +</ul> +<p> + +</p> +<ul><li> +Draw lines, arcs, polylines and polygons and filled polygons or circular shapes (for showing river edges etc.) +</li> +</ul> +<p> + +</p> +<ul><li> +Draw table edges, Bench-work and dimension lines +</li> +</ul> +<p> + +</p> +<ul><li> +Elevations, grades and profiles +</li> +</ul> +<p> + +</p> +<ul><li> +Extend (or shrink) a segment by dragging its Endpoint +</li> +</ul> +<p> + +</p> +<ul><li> +Extend a segment with a curve (or straight) +</li> +</ul> +<p> + +</p> +<ul><li> +Generate parts list for all or selected areas of the layout +</li> +</ul> +<p> + +</p> +<ul><li> +Hand-laid Turnouts +</li> +</ul> +<p> + +</p> +<ul><li> +Helix track +</li> +</ul> +<p> + +</p> +<ul><li> +Hot Bar for Turnout and Structure selection +</li> +</ul> +<p> + +</p> +<ul><li> +Join any two tracks +</li> +</ul> +<p> + +</p> +<ul><li> +Move and rotate any group of objects +</li> +</ul> +<p> + +</p> +<ul><li> +Ninety-nine drawing Layers +</li> +</ul> +<p> + +</p> +<ul><li> +On-line demonstrations, extensive help, tips and error message explanations +</li> +</ul> +<p> + +</p> +<ul><li> +On-screen ruler for measurements +</li> +</ul> +<p> + +</p> +<ul><li> +Panning and zooming via a map window and also in Pan/Zoom Mode +</li> +</ul> +<p> + +</p> +<ul><li> +Price lists can be entered to allow the layout to be priced +</li> +</ul> +<p> + +</p> +<ul><li> +Printing in any scale (up to 1:1) at any position and angle +</li> +</ul> +<p> + +</p> +<ul><li> +Straight and curved flex-track segments +</li> +</ul> +<p> + +</p> +<ul><li> +Supports any scale +</li> +</ul> +<p> + +</p> +<ul><li> +Track circles and tangent tracks +</li> +</ul> +<p> + +</p> +<ul><li> +Train Simulation +</li> +</ul> +<p> + +</p> +<ul><li> +Tunnels (hidden tracks) +</li> +</ul> +<p> + +</p> +<ul><li> +Turnouts, crossings (and sectional track such as Atlas Snap-track) +</li> +</ul> +<p> + +</p> +<ul><li> +Turntables (user defined diameter) +</li> +</ul> +<p> + +</p> +<ul><li> +Undo the last ten commands +</li> +</ul> +<p> + +</p> +<ul><li> +Zoom in and zoom out of the drawing area +</li> +</ul> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Additional XTrackCAD Features</title> +<link rel="previous" href="keyFeatures.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="aboutmanual.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="addFeatures"></a>1.3 Additional <em>XTrackCAD</em> Features</h1> +<p> +<em>XTrackCAD</em> has many other carefully selected features: +</p> +<ul><li> +Sections of track can be hidden, which can be drawn as dashed lines, or completely hidden. A Tunnel Portal is drawn when a hidden track connects with normal track. +</li> +</ul> +<p> + +</p> +<ul><li> +Sections of track can be tagged as bridge tracks which draws a bridge parapet on each side. +</li> +</ul> +<p> + +</p> +<ul><li> +Drawing Turntable stall tracks is easy, just drag from the Turntable with the Modify command. The minimum angle between tracks can be set to ensure accurate, evenly spaced tracks. +</li> +</ul> +<p> + +</p> +<ul><li> +Connections to non-visible layers are marked to an arrow head to show you the track continues on another layer. +</li> +</ul> +<p> + +</p> +<ul><li> +The Group command can be used to decorate custom designed Turnouts and Sectional Track with details to indicate switch machines, ground throws and power connections. +</li> +</ul> +<p> + +</p> +<ul><li> +Custom designed Turnouts can be modified, renamed or deleted with the Custom Management dialog. +</li> +</ul> +<p> + +</p> +<ul><li> +Flex-track connected to Turnouts is labeled with the total length to aid cutting flex-track to length. +</li> +</ul> +<p> + +</p> +<ul><li> +An on-screen ruler can be user to measure arbitrary distances. +</li> +</ul> +<p> + +</p> +<ul><li> +At 1:1 drawing (and printing) scale the track center line is drawn to make it easy to position roadbed and track. +</li> +</ul> +<p> + +</p> +<ul><li> +The balloon help for the Undo and Redo buttons shows the command that would be Undone or Redone. +</li> +</ul> +<p> + +</p> +<ul><li> +The Snap Grid can positioned at any origin and any angle. It can also be printed to help when transferring coordinates to the layout. +</li> +</ul> +<p> + +</p> +<ul><li> +The Map window is used to position the Main window on the layout. It can also be used to change the drawing scale. +</li> +</ul> +<p> + +</p> +<ul><li> +You can rescale and flip objects, trim turnouts and create block gaps. +</li> +</ul> +<p> + +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>About This Manual</title> +<link rel="previous" href="addFeatures.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="installSoftware.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="aboutmanual"></a>1.4 About This Manual</h1> +<p> +<a name="i0"></a><strong>Typographic Conventions</strong> +</p> +<p> +Throughout this manual the following typographic conventions are used to make finding information easier: +</p> +<dl><dd> +<strong>Bold</strong> - Shows menu, file or dialog item titles. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<code>Mono-spaced</code> - Shows commands or text entries by user. On entry fields the spelling given has to be followed exactly. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<em>Italic</em> - Marks a new expression, usually followed by a short description +</dd> +</dl> +<p> + +</p> +<dl><dd> +<code>Capital Key</code> - Usually used in a sequence of key strokes or in combination with <em>Shift, Alt or Ctrl</em> key. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<code>Key+Key</code> - Combination of keys, e.g., <code>Ctrl+S</code> +</dd> +</dl> +<p> + +</p> +<dl><dd> +<code>Key, Key, Key</code> - Sequence of key strokes, e.g., <code>Alt, F, S</code> +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Selection>Selection</strong> - Sequence of selections from menu, e.g., <strong>File>Save</strong> +</dd> +</dl> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Installation</title> +<link rel="previous" href="aboutmanual.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSWinInstall.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="installSoftware"></a>1.5 Installation</h1> +<p> +<em>XTrackCAD</em> is designed to operate under Linux, Apple MacOS or Microsoft Windows. Information within this section of the manual pertains to installation of the application in either of these environments. +</p> +<hr> +<ul> +<li><a href="MSWinInstall.html#MSWinInstall">1.5.1 Microsoft Windows Installation</a></li> +<li><a href="OSXInstall.html#OSXInstall">1.5.2 OSX Installation Mac Installation</a></li> +<li><a href="LinuxInstall.html#LinuxInstall">1.5.3 Linux Installation</a></li> +</ul> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Microsoft Windows Installation</title> +<link rel="previous" href="installSoftware.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="OSXInstall.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSWinInstall"></a>1.5.1 <a name="i0"></a>Microsoft Windows Installation</h1> +<p> +<em>XTrackCAD</em> is shipped as a self-installing self-expanding program (executable). +</p> +<ol><li> +Using Windows Explorer, locate the directory in which you downloaded or copied your new version of <em>XTrackCAD</em>. +<p> + +</p> + +</li> +<li> +Start the installation program by double clicking on the <strong>xtrkcad-setup-5.3.0GA.exe</strong> file icon. +<p> + +</p> + +</li> +<li> +Follow the steps in the installation program. +<p> + +</p> + +</li> +<li> +The installation lets you define the directory in which <em>XTrackCAD</em> is installed. The directory is created automatically if it doesn't already exist. +<p> + +</p> + +</li> +<li> +A program folder named <code>XTrkCad</code> will be created during the installation process. The folder contains the program, documentation, parameter and example files. +</li> +</ol> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>OSX Installation Mac Installation</title> +<link rel="previous" href="MSWinInstall.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="LinuxInstall.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="OSXInstall"></a>1.5.2 <a name="i0"></a>OSX Installation <a name="i1"></a>Mac Installation</h1> +<p> +<em>XTrackCAD</em> for OSX is shipped as a package containing an application. +</p> +<ol><li> +Start the installation by opening the package and dragging the contained application into the <em>Applications</em> folder using the shortcut in the package. The application includes the program, documentation, parameter and example files within it. +<p> + +</p> + +</li> +<li> +To run on Apple MacOS, the <em>XQuartz</em> package must first have been installed - see <a href="http://www.xquartz.org" target="_blank">http://www.xquartz.org</a>. XQuartz will need to be upgraded after each OS version upgrade. +<p> + +</p> + +</li> +<li> +<a name="i2"></a>OSX Run Security When the application is first run, it will need to be authorized by OSX. There will be a OSX prompt that asks if it should be opened. And then it will still fail to run. After opening it for the first time, go to <em>System Preferences>Security & Privacy</em> and you will see that the app is named as having been blocked. Hit the <em>Run Anyway</em> button and the program should start. This sequence may be necessary after each OS upgrade. +</li> +<li> +On Mac OS Catalina, the program will need to be started by right-clicking it and selecting <strong>Open</strong>. +</li> +</ol> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Linux Installation</title> +<link rel="previous" href="OSXInstall.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="startSoftware.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="LinuxInstall"></a>1.5.3 <a name="i0"></a>Linux Installation</h1> +<p> +<em>XTrackCAD</em> for LINUX is shipped as a self-extracting archive (executable). +</p> +<ol><li> +Installing from the self-extracting archive. +<dl><dd> +After downloading open a command line then +</dd> +<dd> +<code>./xtrkcad-setup-5.3.0GA.i386.sh --prefix=/usr/local --exclude-subdir</code> +</dd> +<dd> +This will install the executable in /usr/local/bin. A directory named <code>xtrkcad</code> will be created in /usr/local/share and all files will be unpacked into it. +</dd> +</dl> + +</li> +</ol> +<p> +If you install <em>XTrackCAD</em> into another directory, set the <code>XTRKCADLIB</code> environment variable to point to that directory. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Start the Program</title> +<link rel="previous" href="LinuxInstall.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="introQT.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="startSoftware"></a>1.6 <a name="i0"></a>Start the Program</h1> +<p> +The <em>XTrackCAD</em> executable is named xtrkcad.exe on Windows and xtrkcad on Linux and OSX. +</p> +<p> +It is usually started by clicking on its icon, or right-click and <strong>Open</strong> in OSX Catalina, but there are command line options as well. +</p> +<p> +<strong>Command Line</strong> +</p> +<p> +On Windows: +</p> +<pre><code>xtrkcad [/c config] [/v] [/l logfile] [/d logcontrol] layoutfile +</code></pre> +<p> +On Mac OSX: +</p> +<pre><code>cd /Applications +./open xtrkcad --args [-c config] [-v] [-l logfile] [-d logcontrol] layoutfile +</code></pre> +<p> +On Linux: +</p> +<pre><code>xtrkcad [-c config] [-v] [-l logfile] [-d logcontrol] layoutfile +</code></pre> +<p> +<strong>Command line parameters</strong> +</p> +<dl><dt> +<code>c config</code> +</dt> +<dd> +configuration to use. This allows you to have several distinct configurations (eg. parameter files, display options). +</dd> +</dl> +<p> + +</p> +<dl><dt> +<code>layoutfile</code> +</dt> +<dd> +filename for the layout to load. This parameter takes precedence over the option to resume with the last layout (<a href="cmdPref.html#cmdPref">Section 2.10.7</a>). +</dd> +</dl> +<p> +<strong>Debugging Parameters</strong> +</p> +<p> +The following parameters are for debugging purposes and are mainly of interest to the developers. +</p> +<dl><dt> +<code>v</code> +</dt> +<dd> +verbose mode. +</dd> +</dl> +<p> + +</p> +<dl><dt> +<code>d logcontrol</code> +</dt> +<dd> +specifies the amount of logging. The argument logcontrol has the format <code>logmodule[=level]</code>. logmodule defines the functionality that should be logged, the optional level specifies the loglevel. Zero means no logging. Defaults are no modules are logged and loglevel is 1 if omitted from logonctrol parameter. +</dd> +</dl> +<p> + +</p> +<dl><dt> +<code>l logfile</code> +</dt> +<dd> +set logfile, only needed in conjunction with the debug option. +</dd> +</dl> +<p> + +</p> +<dl><dt> +<code>T</code> +</dt> +<dd> +Runs all Regression tests (Demos) and exits with 0 if all are successful or with 1 if there any failures. Regression progress and failures are logged to stdout (Linux and Mac OSX) or xtclog.txt (Windows). +</dd> +</dl> +<p> + +</p> +<dl><dt> +<code>V</code> +</dt> +<dd> +Display the xtrkcad version and exit(0). +</dd> +</dl> +<p> + +</p> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Quick Tour</title> +<link rel="previous" href="startSoftware.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="performance.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="introQT"></a>1.7 Quick Tour</h1> +<p> +<img src="png.d/main.png"> +</p> +<p> +When <em>XTrackCAD</em> starts, it displays the <strong>Main</strong> (<a href="mainW.html#mainW">Section 3.1</a>) and <strong>Map</strong> (<a href="cmdMap.html#cmdMap">Section 3.2.2</a>) windows. The <strong>Map</strong> window is used to change the origin of the <strong>Main</strong> window when the entire layout cannot be displayed at one time. +</p> +<p> +<img src="png.d/maintagged.png"> +</p> +<p> +The Menu Bar across the top of the <strong>Main</strong> window contains standard Windows menus. Some of these are particularly useful to the new user: +</p> +<ul><li> +The <strong>File>Exit</strong> menu exits <em>XTrackCAD</em>. You can also exit by selecting the System menu in the upper left corner of the Window. +</li> +</ul> +<p> + +</p> +<ul><li> +The <strong>File>Open</strong> menu opens existing layout files and archives. When first installed, the default directory contains some example programs you can look at. +</li> +</ul> +<p> + +</p> +<ul><li> +The <strong>Help</strong> menu can be used to read the <em>XTrackCAD</em> Help file. Also, the <strong>Help>Demos</strong> menu selects a number of demonstrations which illustrate various features of <em>XTrackCAD</em>. +</li> +</ul> +<p> + +</p> +<ul><li> +The <strong>Options>Layout</strong> menu specifies the working scale and overall room size. +</li> +</ul> +<p> + +</p> +<ul><li> +The <strong>Options>Preferences</strong> menu specifies some less frequently changed items. You can use this menu to choose Metric units (<a href="cmdPref.html#cmdPref">Section 2.10.7</a>). +</li> +</ul> +<p> + +</p> +<hr> +<p> +The Tool Bar contains icons for each of the commands in the Menus. The icons shown can be customized using the <strong>View->ToolBar</strong> submenu. +</p> +<ul><li> +The main drawing Mode command is <strong>Select</strong> - which is shown with the red arrow icon. From this mode, selected objects can be <strong>Modified</strong> as well. A close second is the <strong>Describe</strong> mode which allows properties of Objects to be seen and Changed. +</li> +</ul> +<p> + +</p> +<ul><li> +A different mode is <strong>Train</strong> which allows trains to be simulated on the Layout. +</li> +</ul> +<p> + +</p> +<p> +Under the Tool Bar is the Hot Bar. This contains defined track and drawing objects taken from parameter files. To use a template you select it and then click on the Drawing Area. +</p> +<hr> +<p> +The main part of the window is the Drawing Area, this is where the Layout is shown in 2D. The view can be zoomed or panned. The <strong>Pan-Zoom</strong> command whise symbol is the crossed arrows allows easiest control, but in <strong>Select</strong> command you can pan with the arrow keys and zoom with the trackpad or mousewheel or <strong>Ctrl</strong>+"+" or "-" can affect the zoom level. +</p> +<hr> +<p> +At the bottom on the screen are two more areas. The Status Bar contains messages about commands as they are being used, and the Info Bar shows the zoom level and the position of the cursor. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Performance Issues</title> +<link rel="previous" href="introQT.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="directories.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="performance"></a>1.8 Performance Issues</h1> +<p> +This section lists some things that can improve the performance of <em>XTrackCAD</em>. +</p> +<ul><li> +On the <strong>View</strong> dialog (<a href="cmdView.html#cmdView">Section 3.3.11</a>) turn off <strong>Show Snap Grid</strong> or <strong>Change Grid...</strong> to have fewer grid points. +</li> +</ul> +<p> + +</p> +<ul><li> +To speed up initialization, remove unused parameter files (See <strong>Parameter Files</strong> dialog - <a href="cmdPrmfile.html#cmdPrmfile">Section 2.5.7</a>). +</li> +</ul> +<p> + +</p> +<ul><li> +Close the <strong>Map</strong> window if you don't need it to move about the layout. The <strong>Window</strong> (<a href="windowM.html#windowM">Section 2.13</a>) menu can be used reopen the Map window. +</li> +</ul> +<p> + +</p> +<ul><li> +On the <strong>Display</strong> dialog (<a href="cmdDisplay.html#cmdDisplay">Section 2.10.3</a>) turn off drawing <strong>Endpoints</strong>, decrease the <strong>Two Rail Scale</strong>, increase <strong>Min Grid Spacing</strong>, set <strong>Draw Ties</strong> to <strong>None</strong> and turn off <strong>Live Map</strong>. +</li> +</ul> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Files and Directories</title> +<link rel="previous" href="performance.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="dirOverview.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="directories"></a>1.9 Files and Directories</h1> +<p> +Information within this section of the manual identifies installation directory names, file names and directory and file locations. +</p> +<hr> +<ul> +<li><a href="dirOverview.html#dirOverview">1.9.1 Directories Overview</a></li> +<li><a href="installDir.html#installDir">1.9.2 Install Directory</a></li> +<li><a href="workDir.html#workDir">1.9.3 Working Directory</a></li> +</ul> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Directories Overview</title> +<link rel="previous" href="directories.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="installDir.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="dirOverview"></a>1.9.1 <a name="i0"></a>Directories Overview</h1> +<p> +<em>XTrackCAD</em> uses two directories on your system: +</p> +<ul><li> +The <em>XTrackCAD Install</em> directory, which contains the data and parameter files used by <em>XTrackCAD</em>. +</li> +</ul> +<p> + +</p> +<ul><li> +The <em>XTrackCAD Working</em> directory, which contains configuration and Check Point files. +</li> +</ul> +<p> +On MS Windows, the <em>Install</em> directory is set when you install <em>XTrackCAD</em>. All data files (parameters, demos, examples) can be found in the <code>share/xtrkcad</code> subdirectory underneath the <em>Install</em> directory. The <em>Working</em> directory is in your personal profile. +</p> +<p> +On Linux, the <em>Install</em> directory is usually <code>/usr/local/lib/xtrkcad/</code>, but you can change this by defining the <code>XTRKCADLIB</code> environment variable before starting <em>XTrackCAD</em>. The working directory is <code>{HOME}/.xtrkcad/</code>. +</p> +<p> +On Mac OSX, the <em>Install</em> directory is the application package, usually located in the <code>/Applications</code> directory. All the included parameters, demos and examples can be found inside the package under the <code>/Applications/xtrkcad/Contents/Resources/xtrkcad</code> directory. The <em>Working</em> directory is created as <code>.xtrkcad</code> - a hidden directory - under the active user's directory in <code>/Users</code> +</p> +<p> +Layout files (<code>*.xtc</code>) and export (<a href="cmdExport.html#cmdExport">Section 2.5.1</a>) files (<code>*.xti</code>) can be saved anywhere you wish, as specified in the <strong>Save File</strong> and <strong>Open File</strong> dialogs. +</p> +<p> +In MacOS Catalina, the program has no access to certain directories - the Documents and Download directories in particular. +</p> +<p> +Example layouts can be found in the <code>example</code> directory under the <em>XTrackCAD</em> install directory. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Install Directory</title> +<link rel="previous" href="dirOverview.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="workDir.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="installDir"></a>1.9.2 <a name="i0"></a>Install Directory</h1> +<ul><li> +<code>xtrkcad.xtq</code> is the main parameter file which contains definitions for each scale. It also includes turnout definitions for the demos and lists the playback (<em>.xtr</em>) files for the demos. +</li> +</ul> +<p> + +</p> +<ul><li> +<code>params</code> directory contains <code>*.xtp</code> files which are the <em>XTrackCAD</em> Library parameter files. These files (<code>atlasn.xtp, pecon55.xtp, ...</code>) contain definitions for turnouts, sectional track pieces and structures. These files to be used are selected in the <strong>Parameter Files (</strong><a href="cmdPrmfile.html#cmdPrmfile">Section 2.5.7</a><strong>)</strong> dialog. +</li> +</ul> +<p> + +</p> +<ul><li> +<code>xtrkcad.chm</code> (on MS-Windows) is the <em>XTrackCAD</em> help file. +</li> +</ul> +<p> + +</p> +<ul><li> +<code>xtrkcad.exe</code> (MS-Windows) or <code>xtrkcad</code> (Linux or Mac OSX) is the <em>XTrackCAD</em> program. +</li> +</ul> +<p> + +</p> +<ul><li> +<code>xtrkcad.tip</code> contains the Tip of the Day information accessible from the <strong>Help</strong> menu or shown during startup. +</li> +</ul> +<p> + +</p> +<ul><li> +<code>xtrkcad0.ini</code> specifies the location of the <em>XTrackCAD</em> working directory (MS-Windows only). +</li> +</ul> +<p> + +</p> +<ul><li> +<code>demos</code> directory contains <code>*.xtr</code> which are the <em>XTrackCAD</em> demonstration files which can be run via the <strong>Help>Demos</strong> menu item. +</li> +</ul> +<p> + +</p> +<ul><li> +<code>examples</code> directory contain some example <code>.xtc</code> files +</li> +</ul> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Working Directory</title> +<link rel="previous" href="installDir.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="uninstall.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="workDir"></a>1.9.3 <a name="i0"></a>Working Directory</h1> +<ul><li> +<code>xtrkcad.ckp</code> are the <em>check-point</em> files created periodically while running <em>XTrackCAD</em>. If your system <em>XTrackCAD</em> hangs or crashes you get the choice of loading the checkpoint file and so recover (most of) your work by saving it to your current layout file. +<p> +The check-point frequency is set by the <em>Check Point</em> field found in the <strong>Preferences</strong> dialog (<strong>Options>Preferences</strong>). +</p> + +</li> +<li> +The <code>xtrkcad.cus</code> file contains parameter information. This is mostly information created by the <strong>Turnout Designer</strong> dialogs (<a href="cmdTurnoutNew.html#cmdTurnoutNew">Section 2.9.9</a>) and <strong>Group</strong> (<a href="cmdGroup.html#cmdGroup">Section 2.9.4</a>) command. You can use the <strong>Edit>Custom Management</strong> dialog to manipulate these parameters. +</li> +</ul> +<p> + +</p> +<ul><li> +The <code>xtrkcad.ini</code> (on MS-Windows) or the <code>xtrkcad.rc</code> (on Linux or Mac OSX) file contains various parameter settings from each use of <em>XTrackCAD</em>. Most changes you make (such as scale, room size, window position) are saved in this file for the next time you use <em>XTrackCAD</em>. +</li> +</ul> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Removing XTrackCAD</title> +<link rel="previous" href="workDir.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="bugs_enhancements.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="uninstall"></a>1.10 <a name="i0"></a>Removing <em>XTrackCAD</em></h1> +<p> +Remove <em>XTrackCAD</em> by deleting the <em>XTrackCAD Install</em> directory, or application (on Mac OSX), deleting any <code>xtrkcad.*</code> files from the <em>Working</em> directory, and deleting any <em>*.xtc</em> and <em>*.xti</em> files. +</p> +<p> +On MS-Windows only, you can also use the <strong>Uninstall</strong> icon in the <em>XTrackCAD</em> program group. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Bugs and Enhancements</title> +<link rel="previous" href="uninstall.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="bugs.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="bugs_enhancements"></a>1.11 Bugs and Enhancements</h1> +<p> +This section of the manual describes how and where to report a bug or seek an enhancement. +</p> +<hr> +<ul> +<li><a href="bugs.html#bugs">1.11.1 Reporting Bugs</a></li> +<li><a href="enhancements.html#enhancements">1.11.2 Enhancement Requests</a></li> +<li><a href="support.html#support">1.11.3 User Support</a></li> +</ul> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Reporting Bugs</title> +<link rel="previous" href="bugs_enhancements.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="enhancements.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="bugs"></a>1.11.1 Reporting <a name="i0"></a>Bugs</h1> +<p> +If you encounter an unreported bug please submit detail regarding such to the <strong>Bug Tracker</strong> located at the <a href="https://sourceforge.net/p/xtrkcad-fork/bugs/" target="_blank"><em>XTrackCAD</em> Fork Project Site</a>. +</p> +<p> +<strong>Be sure to provide the three basic elements of a bug report:</strong> What you were doing at the time the bug occurred, what you expected to happen and what actually happened. This detail will help developers replicate the error, find and correct the offending code. +</p> +<dl><dt> +<strong>A Sample Bug Report Follows;</strong> +</dt> +</dl> +<p> + +</p> +<dl><dd> +After completing installation of <em>XTrackCAD</em> on a Dell PC with 1024 MB of memory running Windows 7, the following error occurred when attempting to edit a Text Label; +</dd> +</dl> +<p> + +</p> +<dl><dd> +<code>Notice: allocateButt: Can't find 13. Do you want to save the layout?</code> +</dd> +</dl> +<p> + +</p> +<dl><dd> +Selecting either "Yes" or "No" results in a Windows error and <em>XTrackCAD</em> closes. +</dd> +</dl> +<p> + +</p> +<dl><dd> +The error can be replicated by opening the file named cascade.xtc. Set the magnification at 4:1. Attempting to move the text label named "Granville Island" located at the approximate grid coordinates of x=8", y=4' 5". Selecting the label causes the error to occur. +</dd> +</dl> +<p> + +</p> +<dl><dd> +The error is repeatable with other files contain text labels. +</dd> +</dl> +<p> +<strong>Always search the bug database first.</strong> Advice so good, we'll repeat it twice. Always search the bug database first. The odds are good that if you've found a problem, someone else found it too. If you spend a few minutes of your time making sure that you're not filing a duplicate bug, that's a few more minutes someone can spend helping to fix that bug rather than sorting out duplicate bug reports. +</p> +<p> +<strong>If you don't understand an error message, ask for help.</strong> Don't report an error message you don't understand as a bug. There are a lot of places you can ask for help in understanding what is going on before you can claim that an error message you do not understand is a bug. (Once you've understood the error message and have a good suggestion for a way to make the error message clearer, you might consider reporting it as a <a href="https://sourceforge.net/p/xtrkcad-fork/feature-requests/" target="_blank"><em>XTrackCAD</em> Feature Request</a>). +</p> +<p> +<strong>Please be brief, but don't leave any important details out.</strong> This is a fine line to walk. But there are some general guidelines: +</p> +<p> +Remember the three basics: what you were doing, what you expected to happen, and what happened. +</p> +<p> +If you can recreate the problem the <strong>Macro>Record</strong> command can be used to record what happened. Try to isolate the problem by creating a minimal layout and recording as few commands as possible. +</p> +<p> +<strong>Don't report bugs about old versions.</strong> Every time a new version of <em>XTrackCAD</em> is released, many enhancements are added and known bugs are fixed. If you're using a version of <em>XTrackCAD</em> that's more than two revisions older than the latest version, you should upgrade to the latest version to make sure the bug you are experiencing still exists. (It's not a bad idea to upgrade even if your version is only a version behind the most current one.) +</p> +<p> +<strong>Only report one problem in each bug report.</strong> If you encounter two or more bugs that don't appear to be related create a separate bug report for each one. This makes the task of managing work assignments easier and may result in a quicker fix for the problem. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Enhancement Requests</title> +<link rel="previous" href="bugs.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="support.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="enhancements"></a>1.11.2 <a name="i0"></a>Enhancement Requests</h1> +<p> +Suggestions for improvements are encouraged and welcome. Submit your suggestion to the <em>XTrackCAD</em> <strong>Feature Tracker</strong> located at the <a href="https://sourceforge.net/p/xtrkcad-fork/feature-requests/" target="_blank"><em>XTrackCAD</em> Fork Project Site</a>. +</p> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>User Support</title> +<link rel="previous" href="enhancements.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="commandMenus.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="support"></a>1.11.3 <a name="i0"></a>User Support</h1> +<p> +The developers maintain a forum <a href="https://xtrackcad.groups.io/g/main" target="_blank"><em>XtrackCAD</em> User Forum</a> a Wiki at <a href="http://www.xtrkcad.org/Wikka/HomePage" target="_blank"><em>XTrackCAD</em> Wiki</a> +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Command Menus</title> +<link rel="previous" href="support.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="addM.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"><meta name="AppleTitle" content="Command Menus" /> +</head> +<body> +<h1><a name="commandMenus"></a>Chapter 2: Command Menus</h1> +<hr> +<ul> +<li><a href="addM.html#addM">2.1 Add Menu</a></li> +<ul> +<li><a href="cmdCircle.html#cmdCircle">2.1.1 Circle Track</a></li> +<li><a href="cmdCurve.html#cmdCurve">2.1.2 Curved Track</a></li> +<li><a href="cmdHandLaidTurnout.html#cmdHandLaidTurnout">2.1.3 Hand-laid Turnouts</a></li> +<li><a href="cmdHelix.html#cmdHelix">2.1.4 Helix Track</a></li> +<li><a href="cmdParallel.html#cmdParallel">2.1.5 Parallel Track or Line</a></li> +<li><a href="cmdStraight.html#cmdStraight">2.1.6 Straight Track</a></li> +<li><a href="cmdStructure.html#cmdStructure">2.1.7 Structure</a></li> +<li><a href="cmdNewFixedTrack.html#cmdNewFixedTrack">2.1.8 Fixed-track</a></li> +<li><a href="cmdTurntable.html#cmdTurntable">2.1.9 Turntables</a></li> +<li><a href="cmdBlock.html#cmdBlock">2.1.10 Block</a></li> +<li><a href="cmdSwitchmotor.html#cmdSwitchmotor">2.1.11 Switchmotor</a></li> +<li><a href="cmdSignal.html#cmdSignal">2.1.12 Signal</a></li> +<li><a href="cmdControl.html#cmdControl">2.1.13 Control</a></li> +<li><a href="cmdSensor.html#cmdSensor">2.1.14 Sensor</a></li> +</ul> +<li><a href="changeM.html#changeM">2.2 Change Menu</a></li> +<ul> +<li><a href="cmdRescale.html#cmdRescale">2.2.1 Change Scale</a></li> +<li><a href="clrElev.html#clrElev">2.2.2 Clear Elevations</a></li> +<li><a href="cmdConnect.html#cmdConnect">2.2.3 Connect Tracks</a></li> +<li><a href="cmdConvert.html#cmdConvert">2.2.4 Convert Tracks</a></li> +<li><a href="cmdElevation.html#cmdElevation">2.2.5 Elevation</a></li> +<li><a href="cmdFlip.html#cmdFlip">2.2.6 Flip</a></li> +<li><a href="cmdJoin.html#cmdJoin">2.2.7 Join Tracks and Lines</a></li> +<li><a href="cmdModify.html#cmdModify">2.2.8 Modify</a></li> +<li><a href="cmdMove.html#cmdMove">2.2.9 Move</a></li> +<li><a href="cmdMoveLabel.html#cmdMoveLabel">2.2.10 Move Description</a></li> +<li><a href="cmdPan.html#cmdPan">2.2.11 Pan/Zoom</a></li> +<li><a href="cmdProfile.html#cmdProfile">2.2.12 Profile</a></li> +<li><a href="cmdDescribe.html#cmdDescribe">2.2.13 Properties</a></li> +<li><a href="cmdRaiseElev.html#cmdRaiseElev">2.2.14 Raise or Lower Elevation</a></li> +<li><a href="cmdRotate.html#cmdRotate">2.2.15 Rotate</a></li> +<li><a href="cmdSelect.html#cmdSelect">2.2.16 Select</a></li> +<li><a href="cmdSplit.html#cmdSplit">2.2.17 Split Commands</a></li> +</ul> +<li><a href="cmdDraw.html#cmdDraw">2.3 Draw Menu</a></li> +<ul> +<li><a href="cmdDrawCircles.html#cmdDrawCircles">2.3.1 Circles and Filled Circles</a></li> +<li><a href="cmdDrawCurves.html#cmdDrawCurves">2.3.2 Curved Lines</a></li> +<li><a href="cmdNote.html#cmdNote">2.3.3 Note Variants</a></li> +<li><a href="cmdRuler.html#cmdRuler">2.3.4 Ruler</a></li> +<li><a href="cmdAngle.html#cmdAngle">2.3.5 Protractor</a></li> +<li><a href="cmdDrawShapes.html#cmdDrawShapes">2.3.6 Draw Shapes</a></li> +<li><a href="cmdDrawStraights.html#cmdDrawStraights">2.3.7 Straight Objects</a></li> +<li><a href="DrawOrigin.html#DrawOrigin">2.3.8 Draw Objects Origin</a></li> +<li><a href="cmdText.html#cmdText">2.3.9 Text</a></li> +</ul> +<li><a href="editM.html#editM">2.4 Edit Menu</a></li> +<ul> +<li><a href="cmdSelectIndex.html#cmdSelectIndex">2.4.1 Select By Index</a></li> +<li><a href="cmdAboveBelow.html#cmdAboveBelow">2.4.2 "Move To Front" and "Move to Back" </a></li> +<li><a href="addshortcutkeys.html#addshortcutkeys">2.4.3 Additional Shortcut Keys</a></li> +<li><a href="cmdDelete.html#cmdDelete">2.4.4 Delete</a></li> +<li><a href="cmdTunnel.html#cmdTunnel">2.4.5 Tunnel (Hide Tracks)</a></li> +<li><a href="cmdTies.html#cmdTies">2.4.6 Ties (Draw or Hide Ties)</a></li> +<li><a href="cmdBridge.html#cmdBridge">2.4.7 Bridge (Draw or Hide Abutments)</a></li> +<li><a href="cmdRoadbed.html#cmdRoadbed">2.4.8 Roadbed (Draw or Hide Base)</a></li> +<li><a href="cmdUndo.html#cmdUndo">2.4.9 Undo and Redo </a></li> +</ul> +<li><a href="fileM.html#fileM">2.5 File Menu</a></li> +<ul> +<li><a href="cmdExport.html#cmdExport">2.5.1 Export</a></li> +<li><a href="cmdOutputbitmap.html#cmdOutputbitmap">2.5.2 Export to Bitmap</a></li> +<li><a href="ExportDXF.html#ExportDXF">2.5.3 Export to DXF</a></li> +<li><a href="ExportSVG.html#ExportSVG">2.5.4 Export to SVG</a></li> +<li><a href="cmdImport.html#cmdImport">2.5.5 Import</a></li> +<li><a href="cmdImportM.html#cmdImportM">2.5.6 Import as Module</a></li> +<li><a href="cmdPrmfile.html#cmdPrmfile">2.5.7 Parameter Files</a></li> +<li><a href="cmdSearchgui.html#cmdSearchgui">2.5.8 Choose Parameter Files</a></li> +<li><a href="cmdPrint.html#cmdPrint">2.5.9 Printing</a></li> +<li><a href="printSetup.html#printSetup">2.5.10 Printer Setup</a></li> +<li><a href="cmdPrintMargin.html#cmdPrintMargin">2.5.11 Printer Margin</a></li> +</ul> +<li><a href="helpM.html#helpM">2.6 Help Menu</a></li> +<ul> +<li><a href="cmdDemo.html#cmdDemo">2.6.1 Demo Mode</a></li> +</ul> +<li><a href="cmdHotBar.html#cmdHotBar">2.7 Hot Bar</a></li> +<ul> +<li><a href="Flex-track.html#Flex-track">2.7.1 Flex-track</a></li> +<li><a href="hbStructures.html#hbStructures">2.7.2 Structures</a></li> +<li><a href="hbTurnouts.html#hbTurnouts">2.7.3 Turnouts</a></li> +</ul> +<li><a href="macroM.html#macroM">2.8 Macro Menu</a></li> +<li><a href="manageM.html#manageM">2.9 Manage Menu</a></li> +<ul> +<li><a href="cmdCarinv.html#cmdCarinv">2.9.1 Car Inventory</a></li> +<li><a href="cmdCustmgm.html#cmdCustmgm">2.9.2 Custom Management</a></li> +<li><a href="cmdContmgm.html#cmdContmgm">2.9.3 Layout Control Elements Dialog</a></li> +<li><a href="cmdGroup.html#cmdGroup">2.9.4 Group Dialog</a></li> +<li><a href="cmdLayer.html#cmdLayer">2.9.5 Layers Dialog</a></li> +<li><a href="cmdEnum.html#cmdEnum">2.9.6 Parts List </a></li> +<li><a href="cmdPricelist.html#cmdPricelist">2.9.7 Price List</a></li> +<li><a href="cmdTrain.html#cmdTrain">2.9.8 Train Mode </a></li> +<li><a href="cmdTurnoutNew.html#cmdTurnoutNew">2.9.9 Turnout Designer</a></li> +<li><a href="cmdRefreshSpecial.html#cmdRefreshSpecial">2.9.10 Update Turnouts and Structures</a></li> +<li><a href="cmdUngroup.html#cmdUngroup">2.9.11 Ungroup</a></li> +</ul> +<li><a href="optionM.html#optionM">2.10 Options Menu</a></li> +<ul> +<li><a href="cmdRgbcolor.html#cmdRgbcolor">2.10.1 Colors Dialog</a></li> +<li><a href="cmdCmdopt.html#cmdCmdopt">2.10.2 Command Option Dialog</a></li> +<li><a href="cmdDisplay.html#cmdDisplay">2.10.3 Display Dialog</a></li> +<li><a href="cmdEasement.html#cmdEasement">2.10.4 Easements</a></li> +<li><a href="fontSelW.html#fontSelW">2.10.5 Font Selection</a></li> +<li><a href="cmdLayout.html#cmdLayout">2.10.6 Layout Dialog</a></li> +<li><a href="cmdPref.html#cmdPref">2.10.7 Preferences Dialog</a></li> +<li><a href="cmdSticky.html#cmdSticky">2.10.8 Sticky Dialog</a></li> +</ul> +<li><a href="cmdStatusbar.html#cmdStatusbar">2.11 Status Bar</a></li> +<li><a href="viewM.html#viewM">2.12 View Menu</a></li> +<ul> +<li><a href="cmdMagneticSnap.html#cmdMagneticSnap">2.12.1 Magnetic Snap</a></li> +<li><a href="cmdGrid.html#cmdGrid">2.12.2 Grid Dialog</a></li> +<li><a href="toolbarM.html#toolbarM">2.12.3 </a></li> +<li><a href="cmdZoom.html#cmdZoom">2.12.4 Zoom</a></li> +</ul> +<li><a href="windowM.html#windowM">2.13 Window Menu</a></li> +</ul> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Add Menu</title> +<link rel="previous" href="commandMenus.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdCircle.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="addM"></a>2.1 <a name="i0"></a>Add Menu</h1> +<p> +<img src="png.d/madd.png"> +</p> +<p> +The <strong>Add Menu</strong> has all the actions related to adding track pieces to the layout. +</p> +<dl><dd> +<a name="i1"></a>Straight Track <code>Ctrl+G</code> - lay straight track pieces of arbitrary lengths +</dd> +</dl> +<p> + +</p> +<dl><dd> +<a name="i2"></a>Curve Track - lay curved track pieces using different modes for selecting start and endpoints and radius (<a href="cmdCurve.html#cmdCurve">Section 2.1.2</a>). +</dd> +<dd> +<img src="png.d/maddcurve.png"> +</dd> +</dl> +<p> + +</p> +<dl><dd> +<a name="i3"></a>Circle Track <a name="i4"></a> - place a circle of track by selecting radius, tangent and or center (<a href="cmdCircle.html#cmdCircle">Section 2.1.1</a>). +</dd> +<dd> +<img src="png.d/maddcircle.png"> +</dd> +</dl> +<p> + +</p> +<dl><dd> +<a name="i5"></a>Parallel - <a name="i6"></a> <a name="i7"></a> <a name="i8"></a> <a name="i9"></a> create parallel track or line to existing flex-track, straight or curved track. (<a href="cmdParallel.html#cmdParallel">Section 2.1.5</a>) +</dd> +<dd> +<img src="png.d/maddparallel.png"> +</dd> +</dl> +<p> + +</p> +<dl><dd> +<a name="i10"></a>Fixed-track <a name="i11"></a> <code>Ctrl+T</code> - select a piece of <strong>Fixed-track</strong> and place on layout. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<a name="i12"></a>Hand-laid Turnout <a name="i13"></a> <code>Ctrl+Shift+I</code> - lay a turnout in place on the layout. (<a href="cmdHandLaidTurnout.html#cmdHandLaidTurnout">Section 2.1.3</a>) +</dd> +</dl> +<p> + +</p> +<dl><dd> +<a name="i14"></a>Structure <code>Ctrl+Shift+C</code> - Add a predefined structure to the layout. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<a name="i15"></a>Helix <code>Ctrl+Shift+H</code> - Add a helix. (<a href="cmdHelix.html#cmdHelix">Section 2.1.4</a>) +</dd> +</dl> +<p> + +</p> +<dl><dd> +<a name="i16"></a>Custom Turntable <a name="i17"></a> <code>Ctrl+Shift+N</code> - Place a turntable. (<a href="cmdTurntable.html#cmdTurntable">Section 2.1.9</a>) +</dd> +</dl> +<p> + +</p> +<dl><dd> +<a name="i18"></a>Control Element - Create a control element. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<a name="i19"></a>Block <a name="i20"></a> - Create a block. (<a href="cmdBlock.html#cmdBlock">Section 2.1.10</a>) +</dd> +</dl> +<p> + +</p> +<dl><dd> +<a name="i21"></a>Switchmotor <a name="i22"></a> - Create a switchmotor. (<a href="cmdSwitchmotor.html#cmdSwitchmotor">Section 2.1.11</a>) +</dd> +</dl> +<p> + +</p> +<dl><dd> +<a name="i23"></a>Signal <a name="i24"></a> - Create a signal. (<a href="cmdSignal.html#cmdSignal">Section 2.1.12</a>) +</dd> +</dl> +<p> + +</p> +<dl><dd> +<a name="i25"></a>Control <a name="i26"></a> - Create a control. (<a href="cmdControl.html#cmdControl">Section 2.1.13</a>) +</dd> +</dl> +<p> + +</p> +<dl><dd> +<a name="i27"></a>Sensor <a name="i28"></a> - Create a sensor. (<a href="cmdSensor.html#cmdSensor">Section 2.1.14</a>) +</dd> +</dl> +<hr> +<ul> +<li><a href="cmdCircle.html#cmdCircle">2.1.1 Circle Track</a></li> +<ul> +<li><a href="cmdCircleFixedRadius.html#cmdCircleFixedRadius">2.1.1.1 Circle Fixed Radius</a></li> +<li><a href="cmdCircleTangent.html#cmdCircleTangent">2.1.1.2 Circle Fixed Tangent</a></li> +<li><a href="cmdCircleCenter.html#cmdCircleCenter">2.1.1.3 Circle From Center</a></li> +</ul> +<li><a href="cmdCurve.html#cmdCurve">2.1.2 Curved Track</a></li> +<ul> +<li><a href="cmdCurveEndPt.html#cmdCurveEndPt">2.1.2.1 Curved Track from End Point</a></li> +<li><a href="cmdCurveTangent.html#cmdCurveTangent">2.1.2.2 Curved track from Tangent</a></li> +<li><a href="cmdCurveCenter.html#cmdCurveCenter">2.1.2.3 Curved Track From Center</a></li> +<li><a href="cmdCurveChord.html#cmdCurveChord">2.1.2.4 Curved Track from Chord</a></li> +<li><a href="cmdBezier.html#cmdBezier">2.1.2.5 Curved Bezier Track</a></li> +<li><a href="cmdCornu.html#cmdCornu">2.1.2.6 Create Cornu Track</a></li> +</ul> +<li><a href="cmdHandLaidTurnout.html#cmdHandLaidTurnout">2.1.3 Hand-laid Turnouts</a></li> +<li><a href="cmdHelix.html#cmdHelix">2.1.4 Helix Track</a></li> +<li><a href="cmdParallel.html#cmdParallel">2.1.5 Parallel Track or Line</a></li> +<ul> +<li><a href="cmdParallelTrack.html#cmdParallelTrack">2.1.5.1 Parallel Track</a></li> +<li><a href="cmdParallelLine.html#cmdParallelLine">2.1.5.2 Parallel Lines</a></li> +</ul> +<li><a href="cmdStraight.html#cmdStraight">2.1.6 Straight Track</a></li> +<li><a href="cmdStructure.html#cmdStructure">2.1.7 Structure</a></li> +<li><a href="cmdNewFixedTrack.html#cmdNewFixedTrack">2.1.8 Fixed-track</a></li> +<li><a href="cmdTurntable.html#cmdTurntable">2.1.9 Turntables</a></li> +<li><a href="cmdBlock.html#cmdBlock">2.1.10 Block</a></li> +<li><a href="cmdSwitchmotor.html#cmdSwitchmotor">2.1.11 Switchmotor</a></li> +<li><a href="cmdSignal.html#cmdSignal">2.1.12 Signal</a></li> +<li><a href="cmdControl.html#cmdControl">2.1.13 Control</a></li> +<li><a href="cmdSensor.html#cmdSensor">2.1.14 Sensor</a></li> +</ul> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Circle Track</title> +<link rel="previous" href="addM.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdCircleFixedRadius.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdCircle"></a>2.1.1 <a name="i0"></a>Circle Track</h1> +<p> +<img src="png.d/maddcircle.png"> +</p> +<p> +A circle track <a name="i1"></a> <a name="i2"></a> is a special form of a curved track that extends 360° and has no endpoints. The drop down menu, which allows selection of the Circle Track creation method, is invoked from the down arrow button located on the right side the Circle track button. +</p> +<dl><dd> +<img src="png.d/bcircle.png"> +</dd> +<dd> +<img src="png.d/bmcircle.png"> +</dd> +<dd> +<em>Circle Track Button Menu</em> +</dd> +</dl> +<p> +The three methods (with their Icons and Shortcut keys) used to create a Circle Track are: +</p> +<p> + +</p> +<dl><dd> +<img src="png.d/bcircl1.png"> (<a href="cmdCircleFixedRadius.html#cmdCircleFixedRadius">Section 2.1.1.1</a>) <code>Control+8</code> - Use the Fixed Radius specified on the <a name="i3"></a><em>Circle Radius</em> control displayed on the Status Bar (<a href="mainW.html#mainW">Section 3.1</a>). <code>Left-Drag</code> the Circle track into position. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<img src="png.d/bcircl2.png"> (<a href="cmdCircleTangent.html#cmdCircleTangent">Section 2.1.1.2</a>) <code>Control+9</code> - <code>Left-Drag</code> from tangent point (Edge) of the Circle track to the Center. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<img src="png.d/bcircl3.png"> (<a href="cmdCircleCenter.html#cmdCircleCenter">Section 2.1.1.3</a>) <code>Control+0</code> - <code>Left-Drag</code> from the Center of the Circle track to the edge. +</dd> +</dl> +<p> + +</p> +<p> +If Snap Grid (<a href="cmdGrid.html#cmdGrid">Section 2.12.2</a>) is enabled then circle centers will be constrained to the grid. +</p> +<p> +Circle tracks are useful for fitting curves into corners and other tight places. They're also handy when establishing an initial layout and finding out "what will fit". +</p> +<p> +You can join to and from circles, after which they become curved tracks. +</p> +<hr> +<ul> +<li><a href="cmdCircleFixedRadius.html#cmdCircleFixedRadius">2.1.1.1 Circle Fixed Radius</a></li> +<li><a href="cmdCircleTangent.html#cmdCircleTangent">2.1.1.2 Circle Fixed Tangent</a></li> +<li><a href="cmdCircleCenter.html#cmdCircleCenter">2.1.1.3 Circle From Center</a></li> +</ul> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Circle Fixed Radius</title> +<link rel="previous" href="cmdCircle.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdCircleTangent.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdCircleFixedRadius"></a>2.1.1.1 <a name="i0"></a>Circle Fixed Radius</h1> +<p> +<img src="png.d/bcircl1.png"> +</p> +<p> +(<code>Ctrl+8</code>) Use the Fixed Radius specified on the <a name="i1"></a><em>Circle Radius</em> control displayed on the Status Bar (<a href="mainW.html#mainW">Section 3.1</a>). <code>Left-Drag</code> the Circle track into position. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Circle Fixed Tangent</title> +<link rel="previous" href="cmdCircleFixedRadius.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdCircleCenter.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdCircleTangent"></a>2.1.1.2 <a name="i0"></a>Circle Fixed Tangent</h1> +<p> +<img src="png.d/bcircl2.png"> +</p> +<p> +(<code>Ctrl+9</code>) <code>Left-Drag</code> from tangent point (Edge) of the Circle track to the Center. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Circle From Center</title> +<link rel="previous" href="cmdCircleTangent.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdCurve.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdCircleCenter"></a>2.1.1.3 <a name="i0"></a>Circle From Center</h1> +<p> +<img src="png.d/bcircl3.png"> +</p> +<p> +(<code>Ctrl+0</code>) <code>Left-Drag</code> from the Center of the Circle track to the edge. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Curved Track</title> +<link rel="previous" href="cmdCircleCenter.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdCurveEndPt.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdCurve"></a>2.1.2 <a name="i0"></a>Curved Track</h1> +<p> +<img src="png.d/maddcurve.png"> +</p> +<p> +Creating a curve is a two step operation. You will select a point and then <code>Left-Drag</code> to specify the control point depending on the drawing method. +</p> +<p> +A drop-down menu, which allows selection of the Curved Track creation method, is invoked from the down arrow button located on the right side the Curved track button. +</p> +<dl><dd> +<img src="png.d/bcurve.png"> +</dd> +<dd> +<img src="png.d/bmcurved.png"> +</dd> +<dd> +<em>Curved Track Button Menu</em> +</dd> +</dl> +<p> +The six methods (with their Shortcut keys) used to create a Curved Track are: +</p> +<dl><dd> +<img src="png.d/bcurve1.png"> <a href="cmdCurveEndPt.html#cmdCurveEndPt">Section 2.1.2.1</a> <code>Control+4</code> - <a name="i1"></a> <a name="i2"></a> Drag out the end and then set its radius by dragging the endpoint. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<img src="png.d/bcurve2.png"> <a href="cmdCurveTangent.html#cmdCurveTangent">Section 2.1.2.2</a> <code>Control+5</code> - <a name="i3"></a> <a name="i4"></a> Drag from the an endpoint to the center and then drag the second enpoint around that center. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<img src="png.d/bcurve3.png"> <a href="cmdCurveCenter.html#cmdCurveCenter">Section 2.1.2.3</a> <code>Control+6</code> - <a name="i5"></a> <a name="i6"></a> Drag from the Center of the Curved track to one of the endpoints. Position the second endpoint around the center. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<img src="png.d/bcurve4.png"> <a href="cmdCurveChord.html#cmdCurveChord">Section 2.1.2.4</a> <code>Control+7</code> - <a name="i7"></a> <a name="i8"></a> Drag from one endpoint to the other endpoint to form the Chord of the Curve. Drag the arc out to form the Curve. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<img src="png.d/bezier.png"> <a href="cmdBezier.html#cmdBezier">Section 2.1.2.5</a> - Construct a <a name="i9"></a>Bezier Track <a name="i10"></a> by placing its four control points. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<img src="png.d/bcornu.png"> <a href="cmdCornu.html#cmdCornu">Section 2.1.2.6</a> - Construct a <a name="i11"></a>Cornu Track <a name="i12"></a> curve by selecting the end points and dragging to set the curve values. +</dd> +</dl> +<p> + +</p> +<p> +For the first four curve mthods, two Red arrow heads will be drawn after the first step to indicate where you can <code>Left-Drag</code> to complete the second step. +</p> +<p> +A straight track will be created if the second endpoint is lined up with the first endpoint except for Bezier and Cornu tracks. +</p> +<p> +The radius of the curve is designed to be in 1/8" increments unless the <em>desired radius</em> field is set non-zero and the radius drawn is close to that value, in which case the radius will snap to that value. +</p> +<p> +If the Snap Grid (<a href="cmdGrid.html#cmdGrid">Section 2.12.2</a>) is enabled then the endpoints will be constrained to the grid if they are not snapped to another object. <code>Shift</code> ensures that other objects will be ignored. +</p> +<p> +Optionally, the curve center point and radius can be displayed for the Curve. This is enabled by the Move Label (<a href="cmdMoveLabel.html#cmdMoveLabel">Section 2.2.10</a>) command. +</p> +<p> +For Beziers and Cornus, the active control point will be drawn in red and the available endpoints are shown with circles. +</p> +<p> +<strong>Note:</strong> You can also create Straight and Curved tracks using <a href="cmdModify.html#cmdModify">section 2.2.8</a> by <code>Left-Drag</code>ging out extra track from an open end-point. +</p> +<hr> +<ul> +<li><a href="cmdCurveEndPt.html#cmdCurveEndPt">2.1.2.1 Curved Track from End Point</a></li> +<li><a href="cmdCurveTangent.html#cmdCurveTangent">2.1.2.2 Curved track from Tangent</a></li> +<li><a href="cmdCurveCenter.html#cmdCurveCenter">2.1.2.3 Curved Track From Center</a></li> +<li><a href="cmdCurveChord.html#cmdCurveChord">2.1.2.4 Curved Track from Chord</a></li> +<li><a href="cmdBezier.html#cmdBezier">2.1.2.5 Curved Bezier Track</a></li> +<li><a href="cmdCornu.html#cmdCornu">2.1.2.6 Create Cornu Track</a></li> +</ul> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Curved Track from End Point</title> +<link rel="previous" href="cmdCurve.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdCurveTangent.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdCurveEndPt"></a>2.1.2.1 <a name="i0"></a>Curved Track from End Point</h1> +<p> +<img src="png.d/bcurve1.png"> +</p> +<p> +(<code>Ctrl+4</code>) Drag from one endpoint in the direction of the Curve at that point and release. <code>Left-Drag</code> the red arrows to position the second endpoint. +</p> +<p> +While the first endpoint is being placed, and <strong>MagneticSnap</strong> (<a href="cmdMagneticSnap.html#cmdMagneticSnap">Section 2.12.1</a>) is enabled, unless <em>Alt</em> is held, if the cursor is on a track, the new curve end will "Snap" to the nearest open track endpoint and you will drag out the second end in aligned to that track, once you are dragging the second end it will be restricted to an arc that has the same end angle as the first endpoint. After a track is competed, the new track will be connected to this first track. This will also happen with <strong>MagneticSnap</strong> set off - if <em>Alt</em> is held. +</p> +<p> +If Magnetic Snap does not find a end, if <strong>SnapGrid</strong> is enabled, the ends will snap to the nearest grid point unless <strong>Alt</strong> is held. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Curved track from Tangent</title> +<link rel="previous" href="cmdCurveEndPt.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdCurveCenter.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdCurveTangent"></a>2.1.2.2 <a name="i0"></a>Curved track from Tangent</h1> +<p> +<img src="png.d/bcurve2.png"> +</p> +<p> +(<code>Ctrl+5</code>) Drag from one of the endpoints (which will behave like the first point in "CurvedTrack From End" to the Center of the Curved track and release. <code>Left-Drag</code> on the arrows to position the second endpoint. +</p> +<p> +While the endpoints are being placed, if <strong>MagneticSnap</strong> (<a href="cmdMagneticSnap.html#cmdMagneticSnap">Section 2.12.1</a>) is enabled, unless <code>Alt</code> is held down, they will "Snap" to an open track endpoint of the tracks underneath the cursor and you can only drag out the control point aligned to the end of those tracks. After the new track is completed, it will be connected to these existing track. If <strong>MagneticSnap</strong> is disabled, the snap will only happen if <em>Alt</em> is held. If Magnetic Snap does not find a end, if <strong>SnapGrid</strong> is enabled, the end will snap to the nearest grid point unless <strong>Alt</strong> is held. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Curved Track From Center</title> +<link rel="previous" href="cmdCurveTangent.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdCurveChord.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdCurveCenter"></a>2.1.2.3 <a name="i0"></a>Curved Track From Center</h1> +<p> +<img src="png.d/bcurve3.png"> +</p> +<p> +(<code>Ctrl+6</code>) Drag from the Center of the Curved track to one of the endpoints and release. <code>Left-Drag</code> to position the second endpoint. +</p> +<p> +While the endpoints are being placed, if <strong>MagneticSnap</strong> (<a href="cmdMagneticSnap.html#cmdMagneticSnap">Section 2.12.1</a>) is enabled, unless <code>Alt</code> is held down, they will "Snap" to an open track endpoint of the tracks underneath the cursor and you can only drag out the control point aligned to the end of those tracks. After the new track is completed, it will be connected to these existing track. If <strong>MagneticSnap</strong> is disabled, the snap will only happen if <em>Alt</em> is held. If Magnetic Snap does not find a end, if <strong>SnapGrid</strong> is enabled, the end will snap to the nearest grid point unless <strong>Alt</strong> is held. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Curved Track from Chord</title> +<link rel="previous" href="cmdCurveCenter.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdBezier.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdCurveChord"></a>2.1.2.4 <a name="i0"></a>Curved Track from Chord</h1> +<p> +<img src="png.d/bcurve4.png"> +</p> +<p> +(<code>Ctrl+7</code>) Drag from one endpoint to the other endpoint to form the Chord of the Curve and release. <code>Left-Click</code> on the center of the track and Drag to form the Curve. The first end point acts like "CurvedTrack From End". If an exitsing track end is selected, the Chord will only move along line orthogonal to the track. +</p> +<p> +While the endpoints are being placed, if <strong>MagneticSnap</strong> (<a href="cmdMagneticSnap.html#cmdMagneticSnap">Section 2.12.1</a>) is enabled, unless <code>Alt</code> is held down, they will "Snap" to an open track endpoint of the tracks underneath the cursor and you can only drag out the control point aligned to the end of those tracks. After the new track is completed, it will be connected to these existing track. If <strong>MagneticSnap</strong> is disabled, the snap will only happen if <em>Alt</em> is held. If Magnetic Snap does not find a end, if <strong>SnapGrid</strong> is enabled, the end will snap to the nearest grid point unless <strong>Alt</strong> is held. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Curved Bezier Track</title> +<link rel="previous" href="cmdCurveChord.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdCornu.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdBezier"></a>2.1.2.5 <a name="i0"></a>Curved Bezier Track</h1> +<p> +<img src="png.d/bezier.png"> +</p> +<p> +<code>Left-Click</code> to place one endpoint and <code>Left-Drag</code> out the first control point and release, <code>Left-Click</code> to place the second Endpoint and <code>Left-Drag</code> out the second control point and release. Once all 4 points are placed, you can pick one at a time and drag it to move it. Complete the Curve by pressing <code>Enter|, or Reject it with c{Esc</code>. +</p> +<p> +While the endpoints are being placed, if <strong>MagneticSnap</strong> (<a href="cmdMagneticSnap.html#cmdMagneticSnap">Section 2.12.1</a>) is enabled, unless <code>Alt</code> is held down, they will "Snap" to an open track endpoint of the tracks underneath the cursor and you can only drag out the control point aligned to the end of those tracks. After the new track is completed, it will be connected to these existing track. If <strong>MagneticSnap</strong> is disabled, the snap will only happen if <em>Alt</em> is held. If Magnetic Snap does not find a end, if <strong>SnapGrid</strong> is enabled, the end will snap to the nearest grid point unless <strong>Alt</strong> is held. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Create Cornu Track</title> +<link rel="previous" href="cmdBezier.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdHandLaidTurnout.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdCornu"></a>2.1.2.6 <a name="i0"></a>Create Cornu Track</h1> +<p> +<img src="png.d/bcornu.png"> +</p> +<dl><dd> +<code>Left-Click</code> to place each endpoint on an open track end or just on the layout. During the move to the click, if <strong>MagneticSnap</strong> (<a href="cmdMagneticSnap.html#cmdMagneticSnap">Section 2.12.1</a>) is enabled, an anchor will show when the cursor is near an open end point. This can be inhibited with <em>Alt</em>. If <strong>MagneticSnap</strong> is disabled this will only happen if <em>Alt</em> is held. If Magnetic Snap does not find a end, if <strong>SnapGrid</strong> is enabled, the end will snap to the nearest grid point unless <strong>Alt</strong> is held. +</dd> +</dl> +<p> +<code>Left-Drag</code> if the endpoint not on an existing track drags out the end angle of the new track. This is shown by the Cornu endanchor. +</p> +<p> +<img src="png.d/cornuendanchor.png"> +</p> +<p> +The anchor is only drawn for Cornu ends that are not joined to existing tracks and it shows the position, direction and radius of the track, and has anchors for altering these properties. When the Cornu is joined to a track, it uses the properties of the end of that track instead. Anchor point handles are drawn outside the end of the Cornu track to allow track-pins to be edited on the track itself. <code>Left-Click</code> to place the second Endpoint either on a track endpoint or not. <code>Left-Drag</code> sets the second end angle like the first for unconnected end-points. +</p> +<p> +Complete the Curve by pressing <code>Enter</code>, or Reject it with <code>Esc</code>. +</p> +<p> +The radius and angle of the selected open Cornu end can also be set with text entry boxes in the Status Bar. +</p> +<p> +When either endpoint is being moved it will "Snap" to an open track endpoint of the tracks underneath the cursor unless <code>Shift</code> is held. You can then only move the endpoint along that track if it is splitable, or in an extension of it. After the new track is completed, it will be connected to these existing tracks. +</p> +<p> +Cornu Track Pins are further explained in <a href="joinCornu.html#joinCornu">Section 2.2.7.4</a> - they constrain the Cornu curve to smoothly pass through thier position as well as satisfying the end conditions. You can place them by clicking on the Cornu and select, <em>Drag</em> to move them around or hit <em>Delete</em> to remove them. +</p> +<p> +If the end is not connected, an anchor will enable the end-angle and radius to be set by dragging. Initially the end radius is set to be zero and the angle will be picked to create a smooth curve given the end angle. Altering the end angle with the anchor resets the radius to zero. +</p> +<p> + +</p> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Hand-laid Turnouts</title> +<link rel="previous" href="cmdCornu.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdHelix.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdHandLaidTurnout"></a>2.1.3 <a name="i0"></a>Hand-laid Turnouts</h1> +<p> +<img src="png.d/bhndldto.png"> +</p> +<p> +Hand-laid turnouts are created by specifying 3 values: +</p> +<ul><li> +Position of <em>Frog</em> +</li> +<li> +Angle of <em>Frog</em> (the frog number) +</li> +<li> +Position of <em>Points</em> +</li> +</ul> +<p> +First select the position for the Frog (<a href="generalTerms.html#generalTerms">Section B.2</a>) on an existing track and then <em>Drag</em> away to specify the angle of the <em>Frog</em>. The angle in degrees and equivalent frog number is displayed on the status bar. When you release, the line indicating the angle jumps to one side of the track to show you the center line of the new leg of the turnout. +</p> +<p> +Next <code>Left-Click</code> and <code>Left-Drag</code> to position the Points (<a href="generalTerms.html#generalTerms">Section B.2</a>) for the turnout. As you <code>Left-Drag</code>, tracks will be drawn showing the turnout. When you release the turnout is created. +</p> +<p> +You cannot place the <em>Frog</em> or <em>Points</em> on a turnout, circle or helix. However, you can create overlapping Hand-laid Turnouts. +</p> +<p> +There are constraints on where you can place the <em>Points</em> in relation to the <em>Frog</em>. You cannot place the <em>Points</em> too close the <em>Frog</em>. When placing Hand-laid Turnout on a curved track you may get unexpected results, especially when placing the <em>Points</em> a long way from the <em>Frog</em>. Try changing the <em>Frog</em> angle to get different results. +</p> +<p> +Note: the drawing is an approximation to show the location of the <em>Points</em> and <em>Frog</em>. The piece of track considered (by <em>XTrackCAD</em>) to be a Hand-laid Turnout is a short section of track located at the <em>Points</em> and extending toward the <em>Frogs</em>. Other track segments are created between the <em>Points</em> and <em>Frog</em> and a short straight segment is drawn after the <em>Frog</em>. These other segments are independent of the turnout and can be removed or modified, although this is probably not a good idea. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Helix Track</title> +<link rel="previous" href="cmdHandLaidTurnout.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdParallel.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdHelix"></a>2.1.4 <a name="i0"></a>Helix Track</h1> +<p> +<img src="png.d/bhelix.png"> +</p> +<p> +A helix track is used to change the elevation of track in a restricted space. A helix is drawn as a circle of track, but in 3 dimensions it would resemble a cork screw or the pattern of threads on a bolt. +</p> +<p> +<img src="png.d/ahelix.png"> +</p> +<p> +A helix is defined by the number of <em>Turns</em> and <em>Radius</em>. +</p> +<p> +The helix dialog allows you to calculate these values based other parameters such as the <em>Elevation Difference</em>, <em>Grade</em>, <em>Vertical Angular Separation</em>. <em>Angular Separation</em> is the difference in degrees between tracks entering and exiting the helix. Changing any of these values effects the other values. For example, increasing the <em>Radius</em> decreases the <em>Grade</em>. Changing the number of <em>Turns</em> affects the <em>Vertical Separation</em> and either the <em>Radius</em> or <em>Grade</em>. +</p> +<p> +In the case where different parameters could be affected (for instance changing <em>Elevation Difference</em> can affect <em>Radius</em> or <em>Grade</em>) the last parameter you changed will be preserved. If you set the <em>Grade</em> and then <em>Elevation Difference</em> then the <em>Radius</em> will be adjusted. +</p> +<p> +Changing <em>Vertical Separation</em> affects <em>Turns</em> which must be an integer value (no fractions), and this in turn affects the <em>Vertical Separation</em>. When you set <em>Vertical Separation</em> you are specifying the minimum separation which is adjusted upwards to the actual value. +</p> +<p> +The separation is rail-head to rail-head and you need to ensure this is enough to provide clearance when track, sleepers, ballast, baseboard/benchwork is included. +</p> +<p> +Note: only the <em>Radius</em> and <em>Turns</em> are used when creating the helix. After joining the helix to other tracks, you will want to establish the heights of the endpoints at each end of the helix. You can use the Elevation (<a href="cmdElevation.html#cmdElevation">Section 2.2.5</a>) command to do this. +</p> +<p> +A helix is placed the same way as a Circle Track (<a href="cmdCircle.html#cmdCircle">Section 2.1.1</a>) with the addition that you specify the number of turns as well the as the radius of the helix. Then the helix is dragged into position on the layout. +</p> +<p> +You can join to a helix in the same way you join to a circle. However, once joined the helix is still drawn as a circle of track. +</p> +<p> +A label for the helix is drawn at it's the center. If the elevations are set (either by a Defined Elevation point or connecting to a Defined Elevation point) for the two ends of the helix then the label contains the computed grade and vertical separation between layers as well as the number of turns and total length. The label can be moved or turned off by the Move Label (<a href="cmdMoveLabel.html#cmdMoveLabel">Section 2.2.10</a>) command. +</p> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Parallel Track or Line</title> +<link rel="previous" href="cmdHelix.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdParallelTrack.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdParallel"></a>2.1.5 <a name="i0"></a>Parallel Track or Line</h1> +<dl><dd> +<img src="png.d/maddparallel.png"> +</dd> +</dl> +<hr> +<p> +You can pick between two Parallel Commands: +</p> +<p> + +</p> +<dl><dd> +<a href="cmdParallelTrack.html#cmdParallelTrack">Section 2.1.5.1</a>. You can create a new track parallel to any straight, curved, bezier, cornu or easement track. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<a href="cmdParallelLine.html#cmdParallelLine">Section 2.1.5.2</a>. You can create a line parallel to any straight, curved, bezier, cornu or easement track or straight lines, curved lines and PolyLines. +</dd> +</dl> +<hr> +<ul> +<li><a href="cmdParallelTrack.html#cmdParallelTrack">2.1.5.1 Parallel Track</a></li> +<li><a href="cmdParallelLine.html#cmdParallelLine">2.1.5.2 Parallel Lines</a></li> +</ul> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Parallel Track</title> +<link rel="previous" href="cmdParallel.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdParallelLine.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdParallelTrack"></a>2.1.5.1 <a name="i0"></a>Parallel Track</h1> +<p> +<img src="png.d/bparallel.png"> +</p> +<p> +Select the Track you want to parallel with <code>Left-Click</code>, and the new parallel track will appear beside it. You control which side the new track will be on by <code>Left-Drag</code>ging the cursor from one side to the other of the selected track before releasing it. +</p> +<p> +<img src="png.d/statusbarparallel.png"> +</p> +<p> +The <strong>Parallel Separation</strong> control (Visible in the Status Bar) displays the intended separation between parallel tracks/line. This value can be changed before selecting a track. The value must be greater than 0.0 if the gauges are equal. +</p> +<ul><li> +If the gauges are equal, a value of 0.0 means that the rail of the second track is overlaid on the first to simulate dual guage track. The railside that the new track "shares" is set by which side of center the cursor is on when released. The new track will have NoTies set on. +</li> +<li> +The seperation can be automatically increased using the <strong>Radius Factor</strong> value. If this is set to 0.0 (default) the seperation value will be used regardless of radius. If the value is set to 1.0, the seperation will be increased by a scaled 2864 inches per inch of curvature of the paralled track - this is in accordance with North American prototype practice. Other values of Radius Factor will alter by an equivalent percentage. For example, 0.5 would use 50% of this increase. +</li> +</ul> +<p> + +</p> +<p> +This command is very useful for creating sidings and yards as well as dual track. +</p> +<ul><li> +No parallel to a turnouts or a non-straight piece of sectional track is created. +</li> +<li> +It is possible to create tracks that abut (the endpoints are very close and aligned). These endpoints will be automatically connected. +</li> +</ul> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Parallel Lines</title> +<link rel="previous" href="cmdParallelTrack.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdStraight.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdParallelLine"></a>2.1.5.2 <a name="i0"></a>Parallel Lines</h1> +<p> +<img src="png.d/bparalleline.png"> +</p> +<p> +Select the Track or Line you want to parallel with <code>Left-Click</code>, and the new parallel line will appear beside it. +</p> +<ul><li> +Note that Lines are not joined - if you wish you can select a series of Lines and turn them into a PolyLine using <a href="cmdJoinLine.html#cmdJoinLine">Section 2.2.7.1</a>. +</li> +</ul> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Straight Track</title> +<link rel="previous" href="cmdParallelLine.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdStructure.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdStraight"></a>2.1.6 <a name="i0"></a>Straight Track</h1> +<p> +<img src="png.d/bstraigh.png"> +</p> +<p> +Straight track is a created by <code>Left-Click</code> to select the first endpoint then <code>Left-Drag</code>ing the cursor to the point where you want the second endpoint to be. Unless <code>Shift</code> is held down when the first endpoint is being placed and the cursor is on a track, the new straight end will "Snap" to the nearest open track endpoint and you can drag out the second end aligned to that track. After a track is competed, the new track will be connected to the existing track. +</p> +<p> +If the Snap Grid (<a href="cmdGrid.html#cmdGrid">Section 2.12.2</a>) is enabled then the endpoints will be constrained to the grid. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Structure</title> +<link rel="previous" href="cmdStraight.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdNewFixedTrack.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdStructure"></a>2.1.7 <a name="i0"></a>Structure</h1> +<p> +<img src="png.d/bstruct.png"> +</p> +<p> +The <strong>Structure</strong> command places diagrams of structures (buildings, bridges and other scenic elements) on the layout. The operation is similar to the Fixed-track (<a href="cmdNewFixedTrack.html#cmdNewFixedTrack">Section 2.1.8</a>) command. +</p> +<p> +<img src="png.d/strsel.png"> +</p> +<p> +When you select a structure from the list, its diagram is drawn in the diagram canvas. The dimensions are also listed on the dialog. +</p> +<p> +The <strong>Structure Selection</strong> dialog will disappear while dragging on the layout if the <strong>Hide</strong> Check Box on the dialog is set. This is useful if you have a small screen. +</p> +<p> +See the Hot Bar (<a href="cmdHotBar.html#cmdHotBar">Section 2.7</a>) command for details on placing Structures on the layout. +</p> +<p> +<strong>Structures</strong> are placed on the layout in same way as <strong>Fixed-tracks</strong> except that there is no <em>Active endpoint</em> and structures do not align with existing tracks. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Fixed-track</title> +<link rel="previous" href="cmdStructure.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdTurntable.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdNewFixedTrack"></a>2.1.8 <a name="i0"></a>Fixed-track</h1> +<p> +<img src="png.d/bturnout.png"> +</p> +<p> +Fixed-track objects (Turnouts, Sectional Tracks and Grouped Object) are added by the <strong>Fixed-track</strong> command, and the <strong>Selection</strong> dialog is displayed which contains a list of available turnouts, sectional tracks and grouped objects for the current scale (<a href="cmdLayout.html#cmdLayout">Section 2.10.6</a>) and a diagram of the selected turnout. +</p> +<p> +You can use the Parameter File Dialog (<a href="cmdPrmfile.html#cmdPrmfile">Section 2.5.7</a>) to control what turnouts are available. +</p> +<p> +<img src="png.d/turnsel.png"> +</p> +<p> +Select a turnout from the scrolling list by <code>Left-Click</code>ing on it. Move to the Layout and <code>Left-Click</code> where the turnout should be placed. The Turnout will snap to nearby flex-tracks or open endpoints. By <code>Left-Drag</code>ing you can move the turnout around. Additional <code>Left-Click</code>s change the way the turnout is placed. +</p> +<p> +The <strong>New</strong> button invokes the Turnout Designer (<a href="cmdTurnoutNew.html#cmdTurnoutNew">Section 2.9.9</a>) dialog. This button displays a pop-up-menu list of various types of turnouts and sectional track. +</p> +<p> +The <strong>Turnout Selection</strong> window will disappear while dragging on the layout if the <strong>Hide</strong> Check Box on the dialog is set. This is useful if you have a small screen. +</p> +<p> +See the Hot Bar (<a href="cmdHotBar.html#cmdHotBar">Section 2.7</a>) command for details on placing Fixed-tracks on the layout. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Turntables</title> +<link rel="previous" href="cmdNewFixedTrack.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdBlock.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdTurntable"></a>2.1.9 <a name="i0"></a>Turntables</h1> +<p> +<img src="png.d/bturntbl.png"> +</p> +<p> +Turntables of specified diameter are created with the <strong>Turntable</strong> command. +</p> +<p> +<img src="png.d/statusbarturntable.png"> +</p> +<p> +The <em>Turntable Diameter</em> control (Visible in the Status Bar) displays the current diameter of the turntable. This value can be changed before dragging the turntable into position. The value must be greater than 0.0. +</p> +<p> +The <strong>Modify command</strong> (<a href="cmdModify.html#cmdModify">Section 2.2.8</a>) can be used to create turntable stall tracks. Select the turntable and drag the stall track to the proper angle and length. You can also connect to a turntable with the <strong>Join command</strong> (<a href="cmdJoin.html#cmdJoin">Section 2.2.7</a>). +</p> +<p> +The <strong>Turntable Angle</strong> control on the Preferences (<a href="cmdPref.html#cmdPref">Section 2.10.7</a>) dialog controls how closely you can place tracks connected to a turntable. If you want to create stall tracks every 7.5°, set the <strong>Turntable Angle</strong> control to 7.5 and place the track as close to each other as allowed. <em>XTrackCAD</em> makes sure they will be separated by the correct angle. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Block</title> +<link rel="previous" href="cmdTurntable.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdSwitchmotor.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdBlock"></a>2.1.10 <a name="i0"></a>Block</h1> +<p> +<img src="png.d/bblock.png"> +</p> +<p> +A block is created by first selecting the track segments in the block and then selecting <strong>Create Block</strong> from either the Add menu <a href="cmdAdd.html#cmdAdd">Section 3.3.1</a> or from the block menu on the hotbar. A block gets a name and a script. The name is only used for identification and the script is used by the layout control software. The script should provide whatever information is needed by the layout control software to determine block occupancy. This could be a code snippet to retrieve the state of the block occupancy or it could be the address of the sensor, etc. +</p> +<p> +<img src="png.d/block.png"> +</p> +<p> +The create block dialog has spaces for two text strings. One is the name and the other is a block occupancy script. The name identifies the block and the script is information used by the layout control software to detect block occupancy. The script could be a code snippet or I/O device address information, etc. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Switchmotor</title> +<link rel="previous" href="cmdBlock.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdSignal.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdSwitchmotor"></a>2.1.11 <a name="i0"></a>Switchmotor</h1> +<p> +<img src="png.d/bswitchmotor.png"> +</p> +<p> +A switchmotor is created by selecting <strong>Create SwitchMotor</strong> from either the Add menu <a href="cmdAdd.html#cmdAdd">Section 3.3.1</a> or from the switchmotor menu on the hotbar and then clicking on a turnout. A switchmotor gets a name and three scripts. The name is only used for identification and the three scripts are used by the layout control software. The three scripts are for throwing the turnout to its "normal" position, throwing the turnout to its "reverse" position, and a script to read a point position sensor. These scripts could be code snippets or they could be addresses of I/O devices, etc. +</p> +<p> +<img src="png.d/switchmotor.png"> +</p> +<p> +The create switchmotor dialog has spaces for four text strings. One is the name and the other three are scripts for Normal, Reverse, and Point Sense. The name identifies the switchmotor and the scripts are information used by the layout control software to throw the turnout to the normal position, throw the turnout to the reverse position, and sense the point position. The scripts could be code snippets or I/O device address information, etc. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Signal</title> +<link rel="previous" href="cmdSwitchmotor.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdControl.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdSignal"></a>2.1.12 <a name="i0"></a>Signal</h1> +<p> +<img src="png.d/bsignal.png"> +</p> +<p> +A signal is created by selecting <strong>Create Signal</strong> from either the Add menu <a href="cmdAdd.html#cmdAdd">Section 3.3.1</a> or from the hotbar. Use the mouse to select a location (left button) and then dragging (left button down) the signal to set its orientation. Once the left button is released, a Create/Edit Signal dialog box is displayed, and you can fill in the signal's properties: name, fine tune the location and orientation, number of heads, and the aspects. +</p> +<p> +<img src="png.d/signal.png"> +</p> +<p> +The create/edit signal dialog has spaces for the name of the signal, its location and orientation, the number of heads (1, 2, or 3), and a list of aspects. Each aspect has a name and a script. The name could be a rule book name (Clear, Aproach, Stop, etc.) or the actual color(s) displayed (green, yellow, red, etc.). The script is just some information for the layout control software to actually effect the display of the aspect -- this could be the LCC event id to trigger the aspect or it could be a code snippet that causes the aspect to be displayed. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Control</title> +<link rel="previous" href="cmdSignal.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdSensor.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdControl"></a>2.1.13 <a name="i0"></a>Control</h1> +<p> +<img src="png.d/bcontrol.png"> +</p> +<p> +A control is created by selecting <strong>Create Control</strong> from either the Add menu <a href="cmdAdd.html#cmdAdd">Section 3.3.1</a> or from the hotbar. Use the mouse to select a location (left button) and then dragging (left button down) the control to where you want it. Once the left button is released, a Create/Edit Control dialog box is displayed, and you can fill in the control's properties: name, fine tune the location, and the on and off scripts. +</p> +<p> +<img src="png.d/control.png"> +</p> +<p> +The create/edit control dialog has entry fields for the name of the control, its location, and a pair of scripts, one to turn the control on and one to turn the control off. The scripts are just some information for the layout control software to actually effect the state on the control (on or off). +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Sensor</title> +<link rel="previous" href="cmdControl.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="changeM.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"><meta name="AppleTitle" content="Change Menu" /> +</head> +<body> +<h1><a name="cmdSensor"></a>2.1.14 <a name="i0"></a>Sensor</h1> +<p> +<img src="png.d/bsensor.png"> +</p> +<p> +A sensor is created by selecting <strong>Create Sensor</strong> from either the Add menu <a href="cmdAdd.html#cmdAdd">Section 3.3.1</a> or from the hotbar. Use the mouse to select a location (left button) and then dragging (left button down) the sensor to where you want it. Once the left button is released, a Create/Edit Sensor dialog box is displayed, and you can fill in the sensor's properties: name, fine tune the location, and the script. +</p> +<p> +<img src="png.d/sensor.png"> +</p> +<p> +The create/edit sensor dialog has spaces for the name of the sensor, its location, and a script. The script is just some information for the layout control software to actually return the state of the sensor (on or off). +</p> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Change Menu</title> +<link rel="previous" href="cmdSensor.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdRescale.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="changeM"></a>2.2 <a name="i0"></a>Change Menu</h1> +<p> +<img src="png.d/mchange.png"> +</p> +<p> +The <strong>Change Menu</strong> has all functions related to modifying objects that exist on the layout drawing. +</p> +<dl><dd> +<a name="i1"></a>Properties - sets <em>XTrackCAD</em> into <em>Describe</em> mode. Whenever an object is clicked on while in this mode, the <strong>Properties</strong> dialog is opened. This dialog allows direct manipulation of settings such as the objects length, position or orientation. (<a href="cmdDescribe.html#cmdDescribe">Section 2.2.13</a>). +</dd> +</dl> +<p> + +</p> +<dl><dd> +<a name="i2"></a>Select - sets <em>XTrackCAD</em> into <em>Select</em> mode. Whenever an object is clicked on while in this mode, this selection state of this object is reversed. If an object was unselected it becomes selected, and vice versa. To unselect all objects press the ESC key, use <strong>Deselect All</strong> from the <strong>Edit</strong> (<a href="editM.html#editM">Section 2.4</a>) menu or <strong>Deselect All</strong> from the <strong>Pop-up</strong> menu (<a href="mouseBcmd.html#mouseBcmd">Section 3.4.1</a>). (<a href="cmdSelect.html#cmdSelect">Section 2.2.16</a>). +</dd> +</dl> +<hr> +<dl><dd> +<a name="i3"></a>Move - move selected object(s). (<a href="cmdMove.html#cmdMove">Section 2.2.9</a>). +</dd> +</dl> +<p> + +</p> +<dl><dd> +<a name="i4"></a>Rotate - rotate selected object(s). (<a href="cmdRotate.html#cmdRotate">Section 2.2.15</a>). +</dd> +</dl> +<p> + +</p> +<dl><dd> +<a name="i5"></a>Flip - turn selected object(s) over or around. (<a href="cmdFlip.html#cmdFlip">Section 2.2.6</a>). +</dd> +</dl> +<p> + +</p> +<dl><dd> +<a name="i6"></a>Loosen Tracks <a name="i7"></a> - this command reverses the effect of Connect Two Tracks as applied to sectional track. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<a name="i8"></a>Modify - modify an existing track, or lines. (<a href="cmdModify.html#cmdModify">Section 2.2.8</a>). +</dd> +</dl> +<p> + +</p> +<dl><dd> +<img src="png.d/mjoin.png"> +</dd> +<dd> +<strong>Join</strong> <a name="i9"></a> <a name="i10"></a> <a name="i11"></a> - connect two separate pieces of track or two lines. This command can be used to move one of the pieces of track to the endpoint of the other or to create a connection by laying a stretch of flex-track. (<a href="cmdJoin.html#cmdJoin">Section 2.2.7</a>). +</dd> +</dl> +<p> + +</p> +<dl><dd> +<a name="i12"></a>Connect Two Tracks <a name="i13"></a> - creates a connection between track pieces with an option to slightly move the select piece(s) and the pieces they connect to. (<a href="cmdConnect.html#cmdConnect">Section 2.2.3</a>). +</dd> +</dl> +<p> + +</p> +<dl><dd> +<img src="png.d/msplit.png"> +</dd> +<dd> +<a name="i14"></a>Split - the <strong>Split</strong> commands are used to divide up tracks (<a href="cmdSplitTrack.html#cmdSplitTrack">Section 2.2.17.1</a>) or split draw objects (<a href="cmdSplitDraw.html#cmdSplitDraw">Section 2.2.17.3</a>) or use a second Object to Trim (<a href="cmdTrimDraw.html#cmdTrimDraw">Section 2.2.17.4</a>). The (<a href="cmdSplitTrack.html#cmdSplitTrack">Section 2.2.17.1</a>) command can be used in one of two ways; +<p> + +</p> +<ul><li> +split a section of flex-track into two connected pieces at the point where a <em>Left-Click</em> is invoked or; +</li> +<li> +disconnect turnouts or sectional track pieces at their point of connection. +</li> +</ul> + +</dd> +<dd> +<a name="i15"></a>Move Description - move the endpoint description of a track piece to another location. (<a href="cmdMoveLabel.html#cmdMoveLabel">Section 2.2.10</a>). +</dd> +</dl> +<hr> +<dl><dd> +<a name="i16"></a>Raise/Lower Elevations - raise or lower elevation of selected tracks. (<a href="cmdRaiseElev.html#cmdRaiseElev">Section 2.2.14</a>). +</dd> +</dl> +<p> + +</p> +<dl><dd> +<a name="i17"></a>Elevation - define an elevation at specified track location (<a href="cmdElevation.html#cmdElevation">Section 2.2.5</a>). +</dd> +</dl> +<p> + +</p> +<dl><dd> +<a name="i18"></a>Profile - display the elevation profile of a definable stretch of track (<a href="cmdProfile.html#cmdProfile">Section 2.2.12</a>). +</dd> +</dl> +<p> + +</p> +<dl><dd> +<a name="i19"></a>Clear Elevations - remove elevation parameters from selected track(s). +</dd> +</dl> +<p> + +</p> +<dl><dd> +<a name="i20"></a>Recompute Elevations - performs a global re-computation of dynamic elevations. It should not be necessary to issue this command as elevations are recomputed as required. +</dd> +</dl> +<hr> +<dl><dd> +<a name="i21"></a>Change Scale - change model scale and/or gauge of layout design. (<a href="cmdRescale.html#cmdRescale">Section 2.2.1</a>) +</dd> +</dl> +<hr> +<dl><dd> +<img src="png.d/mconvert.png"> +</dd> +<dd> +<a name="i22"></a>Convert - changes flex-tracks (Straight, Curve, Joint, Bezier) into a Smooth Cornu or vice versa. (<a href="cmdConvert.html#cmdConvert">Section 2.2.4</a>). +</dd> +</dl> +<hr> +<ul> +<li><a href="cmdRescale.html#cmdRescale">2.2.1 Change Scale</a></li> +<li><a href="clrElev.html#clrElev">2.2.2 Clear Elevations</a></li> +<li><a href="cmdConnect.html#cmdConnect">2.2.3 Connect Tracks</a></li> +<li><a href="cmdConvert.html#cmdConvert">2.2.4 Convert Tracks</a></li> +<ul> +<li><a href="cmdConvertTo.html#cmdConvertTo">2.2.4.1 Convert flex-track(s) to Cornu(s)</a></li> +<li><a href="cmdConvertFrom.html#cmdConvertFrom">2.2.4.2 Convert Cornu(s) and Bezier(s) to flex-track(s)</a></li> +</ul> +<li><a href="cmdElevation.html#cmdElevation">2.2.5 Elevation</a></li> +<ul> +<li><a href="computeElevations.html#computeElevations">2.2.5.1 Computing Dynamic Elevations</a></li> +</ul> +<li><a href="cmdFlip.html#cmdFlip">2.2.6 Flip</a></li> +<li><a href="cmdJoin.html#cmdJoin">2.2.7 Join Tracks and Lines</a></li> +<ul> +<li><a href="cmdJoinLine.html#cmdJoinLine">2.2.7.1 Join Lines</a></li> +<li><a href="cmdJoinTrack.html#cmdJoinTrack">2.2.7.2 Join Tracks</a></li> +<li><a href="joinNormalEasment.html#joinNormalEasment">2.2.7.3 Join with Normal Easement</a></li> +<li><a href="joinCornu.html#joinCornu">2.2.7.4 Join with Cornu Easement</a></li> +<li><a href="cornuTrackPins.html#cornuTrackPins">2.2.7.5 Cornu Track Pins</a></li> +<li><a href="joinTrackStraight.html#joinTrackStraight">2.2.7.6 Using Straight Flex-Track</a></li> +<li><a href="joinTrackMove.html#joinTrackMove">2.2.7.7 By Moving Track</a></li> +</ul> +<li><a href="cmdModify.html#cmdModify">2.2.8 Modify</a></li> +<ul> +<li><a href="extendModify.html#extendModify">2.2.8.1 Extending Track</a></li> +<li><a href="objectModify.html#objectModify">2.2.8.2 Modifying Objects</a></li> +<li><a href="chgTrackLength.html#chgTrackLength">2.2.8.3 Changing Track Length</a></li> +<li><a href="createTangent.html#createTangent">2.2.8.4 Creating a Tangent to a Curve</a></li> +<li><a href="chgTrackRadius.html#chgTrackRadius">2.2.8.5 Changing Track Radius</a></li> +<li><a href="extendTrack.html#extendTrack">2.2.8.6 Extending Track Length</a></li> +<li><a href="chgDraw.html#chgDraw">2.2.8.7 Modifying Draw Elements</a></li> +<li><a href="chgCornu.html#chgCornu">2.2.8.8 Cornu Easements Modifying a Cornu Track</a></li> +<li><a href="chgBezier.html#chgBezier">2.2.8.9 Modifying a Bezier</a></li> +</ul> +<li><a href="cmdMove.html#cmdMove">2.2.9 Move</a></li> +<ul> +<li><a href="moveByMouse.html#moveByMouse">2.2.9.1 Using Mouse</a></li> +<li><a href="moveByMenu.html#moveByMenu">2.2.9.2 Using Values of X and Y Translation</a></li> +</ul> +<li><a href="cmdMoveLabel.html#cmdMoveLabel">2.2.10 Move Description</a></li> +<li><a href="cmdPan.html#cmdPan">2.2.11 Pan/Zoom</a></li> +<li><a href="cmdProfile.html#cmdProfile">2.2.12 Profile</a></li> +<li><a href="cmdDescribe.html#cmdDescribe">2.2.13 Properties</a></li> +<ul> +<li><a href="drawDescribe.html#drawDescribe">2.2.13.1 Draw Object Describe Fields</a></li> +<li><a href="DescribeCompound.html#DescribeCompound">2.2.13.2 Structures, Sectional Track and Turnouts Describe Fields</a></li> +<li><a href="DescribeTrack.html#DescribeTrack">2.2.13.3 Describe Track Fields</a></li> +</ul> +<li><a href="cmdRaiseElev.html#cmdRaiseElev">2.2.14 Raise or Lower Elevation</a></li> +<li><a href="cmdRotate.html#cmdRotate">2.2.15 Rotate</a></li> +<ul> +<li><a href="rotateByMouse.html#rotateByMouse">2.2.15.1 Using Mouse</a></li> +<li><a href="rotateByMenu.html#rotateByMenu">2.2.15.2 Using Degree's of Rotation</a></li> +<li><a href="rotateByAlign.html#rotateByAlign">2.2.15.3 Aligned With Another Object</a></li> +</ul> +<li><a href="cmdSelect.html#cmdSelect">2.2.16 Select</a></li> +<li><a href="cmdSplit.html#cmdSplit">2.2.17 Split Commands</a></li> +<ul> +<li><a href="cmdSplitTrack.html#cmdSplitTrack">2.2.17.1 Split Track</a></li> +<li><a href="splitDisconnect.html#splitDisconnect">2.2.17.2 Disconnect Joint</a></li> +<li><a href="cmdSplitDraw.html#cmdSplitDraw">2.2.17.3 Split a Draw Object</a></li> +<li><a href="cmdTrimDraw.html#cmdTrimDraw">2.2.17.4 Trim a Draw Object using another Draw object</a></li> +</ul> +</ul> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Change Scale</title> +<link rel="previous" href="changeM.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="clrElev.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdRescale"></a>2.2.1 Change Scale</h1> +<p> +<img src="png.d/rescale.png"> +</p> +<p> +<strong>Change Scale</strong> is used to change the size and gauge of selected (<a href="cmdSelect.html#cmdSelect">Section 2.2.16</a>) objects. The amount to resize can be specified +</p> +<p> + +</p> +<ul><li> +by the modeling scale, e.g., convert from HO to O scale +</li> +<li> +by the modeled gauge, e.g., convert from standard gauge to narrow gauge, or +</li> +<li> +by ratio (by 181.5%). +</li> +</ul> +<p> +If the selected objects have multiple Scales then the 1st From box will display "Multi-Scale". If the selected objects are all of one Scale and but have different Gauges then the 2nd From box will display "Multi-Gauge". +</p> +<p> +If resizing by modeling scale then track dimensions, e.g., lengths and radii, will be changed as well. An option is available to disable the resizing of the selected objects. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Clear Elevations</title> +<link rel="previous" href="cmdRescale.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdConnect.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="clrElev"></a>2.2.2 Clear Elevations</h1> +<p> +The <strong>Clear Elevations</strong> command is used to remove elevation points from selected track on the layout. +</p> +<p> +Using the <strong>Select</strong> command, select the track that is to have its elevation settings cleared then select <strong>Change>Clear Elevations</strong> from the menu bar to clear elevations of selected track. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Connect Tracks</title> +<link rel="previous" href="clrElev.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdConvert.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdConnect"></a>2.2.3 Connect Tracks</h1> +<p> +<img src="png.d/bconnect.png"> +</p> +<p> +This command is frequently used with <a name="i0"></a><em>Sectional Track</em>. But it can be useful to reattach ordinary track which has become disconected or split. +</p> +<p> +When in this connect, ends of tracks that can be selected are highlighted with a blue arrow. With <em>Shift</em> added, ends that can be tighten are highlighted with a blue "X". +</p> +<p> +There are three modes, +</p> +<p> + +</p> +<ul><li> +a <strong>Left</strong> click on a track near a disconnected end-point followed by a second on a close-by disconnected end-point on another track will try to join two tracks +</li> +<li> +a <strong>Shift-Left</strong> click on a connected track will "Tighten Tracks" moving other tracks connected to this track to reduce any small distance or angle differences +</li> +<li> +Selecting a set of tracks followed by a <em>"S" key</em> or using the Context menu will prompt for confirmation that all selected tracks with unconnected endpoints should be joined to nearby selected track at an unconnected end point. This mode allows for an entire layout to be reconnected after a Select-All. +</li> +</ul> +<p> +<strong>Notes for two track mode:</strong> Occasionally pieces of sectional track do not line up exactly, especially when creating figure-8's or passing sidings. When laying out the actual track you can compensate for this by adjusting the individual tracks to provide a bit of slack. This command simulates that process. +</p> +<p> +Click on the endpoint of each track you're trying to connect. XtrkCAD will move the tracks slightly in an attempt to overcome the gap. If the gap is too large, the connection will fail. If this occurs, try using other track pieces in your layout. +</p> +<p> +<em>XTrackCAD</em> adjusts the positions of tracks connected to the tracks up to a track with more than two connections. See the Demo for details. +</p> +<p> +If one (or both) the selected tracks is an adjustable section (such as Kato's Adjustable Track #20-050) then the length of the track is changed to fill the gap. +</p> +<p> +You can undo the effect of the <strong>Connect</strong> command by splitting (<a href="splitDisconnect.html#splitDisconnect">Section 2.2.17.2</a>) the track to disconnect it then using the <em>Shift+Left-Click</em> <strong>Connect</strong> command on the unconnected endpoints to tighten connections between the tracks. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Convert Tracks</title> +<link rel="previous" href="cmdConnect.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdConvertTo.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdConvert"></a>2.2.4 Convert Tracks</h1> +<dl><dd> +(<a href="cmdConvertTo.html#cmdConvertTo">Section 2.2.4.1</a>). Convert Fixed to Cornu +</dd> +<dd> +(<a href="cmdConvertFrom.html#cmdConvertFrom">Section 2.2.4.2</a>). Convert Cornu to Fixed. +</dd> +</dl> +<p> +A drop down menu, which allows selection of the Convert Mode, is invoked from the down arrow button (<img src="png.d/bmenu.png">) located on the right side the Convert Tracks button. Dependent upon previous selection, the Convert Track button will look like <img src="png.d/convertto.png"> or <img src="png.d/convertfrom.png">. +</p> +<hr> +<ul> +<li><a href="cmdConvertTo.html#cmdConvertTo">2.2.4.1 Convert flex-track(s) to Cornu(s)</a></li> +<li><a href="cmdConvertFrom.html#cmdConvertFrom">2.2.4.2 Convert Cornu(s) and Bezier(s) to flex-track(s)</a></li> +</ul> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Convert flex-track(s) to Cornu(s)</title> +<link rel="previous" href="cmdConvert.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdConvertFrom.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdConvertTo"></a>2.2.4.1 Convert flex-track(s) to Cornu(s)</h1> +<p> +<img src="png.d/convertto.png"> +</p> +<p> +This command will take a pre-selected set of flex-track elements (Straights, Curves, Joint or Bezier) and convert them into a set of Cornu Tracks. If there are no selected Tracks, the user can click on a single track. +</p> +<p> +The Cornu(s) will smoothly pass through all the end points of the selected tracks and smoothly join to the end-points (if any). This may change the internal shape of the resulting track(s) due to smoothing. A subsequent <a href="cmdModify.html#cmdModify">section 2.2.8</a> can be used to fine tune the Cornu(s) by moving, adding and deleting "pins" in the combined shape. +</p> +<p> +This command is intended to help conversion of track designs that were made before Cornu Track existed to Cornu. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Convert Cornu(s) and Bezier(s) to flex-track(s)</title> +<link rel="previous" href="cmdConvertTo.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdElevation.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdConvertFrom"></a>2.2.4.2 Convert Cornu(s) and Bezier(s) to flex-track(s)</h1> +<p> +<img src="png.d/convertfrom.png"> +</p> +<p> +This command will take a pre-selected set of Cornu and Bezier Tracks and convert them into a set of equivalent Straights or Curves, +</p> +<p> +The resulting track(s) will mimic the shape of the Cornu/Bezier(s) exactly. This command is intended to allow easier layout of smoothed shapes. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Elevation</title> +<link rel="previous" href="cmdConvertFrom.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="computeElevations.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdElevation"></a>2.2.5 Elevation</h1> +<p> +<img src="png.d/belev.png"> +</p> +<p> +The <strong>Elevation</strong> command changes the elevation of track endpoints. After opening this dialog, The Message Bar will show the computed elevation at the cursor. There will be an open blue circle if an endpoint will be selected with <strong>Left-Click</strong>. You click on the respective endpoint to set its elevation properties. +</p> +<p> +The endpoint which you are working on is indicated with a big red dot. Note that when an endpoint is selected, the Elevation Window will have focus. To select a different endpoint without closing this window, two clicks (or a double click) will be needed. The first click restores focus to the main window, the second selects the point. +</p> +<p> +If you add <strong>Shift</strong> as you move the cursor before clicking you will see a blue bar when it is over a track if a <strong>Shift+Left-Click</strong> will split the Track at that point (which will give you the opportunity to specify an elevation). +</p> +<p> +Adding <strong>Ctrl</strong> allows you to <strong>Ctrl+Left-Click</strong> to Select and <strong>Left-Drag</strong> to move existing Elevation Labels if the option is set for them to be displayed and the Zoom level is adequate, Only "Defined" and "Station" endpoint labels can be moved. +</p> +<p> +If you add <strong>Alt</strong>, while moving around the layout close to tracks will show you the elevation at the point indicated by a blue closed dot. +</p> +<p> +With <strong>Alt</strong> held, if you hover over a point close to where two unconnected tracks pass over one another, a blue square will be drawn and the Message Bar will show the two elevations and the Clearance between them. +</p> +<p> +Clicking with <strong>Shift</strong> at this point will split the track, allowing the elevation to be adjusted to provide adequate clearance. +</p> +<p> +<img src="png.d/celev.png"> +</p> +<p> +An endpoint can have one of several elevation types: +</p> +<p> + +</p> +<ul><li> +<strong>None</strong> - no elevation control defined. This is the default state and the elevation will be computed. It will be shown if the Display Option <a href="cmdDisplay.html#cmdDisplay">Section 2.10.3</a> <strong>EndPt Elevations</strong> setting is on. +</li> +<li> +<strong>Defined</strong> - the defined elevation is set to a specified height. The elevation will be shown. +</li> +<li> +<strong>Hidden</strong> - a defined elevation like <strong>Defined</strong> but not displayed on the layout. +</li> +<li> +<strong>Computed</strong> - height is calculated and displayed even if the Display Option <a href="cmdDisplay.html#cmdDisplay">Section 2.10.3</a> <em>EndPt Elevations</em> is on. +</li> +<li> +<strong>Grade</strong> - grade is based on height of closest neighbors and displayed. +</li> +<li> +<strong>Ignored</strong> - endpoint is not considered in computations. This breaks the flow of the elevation influence from one side to the other, resulting in an elevation that is not dependent on the connected track but on the other connected tracks. A common use would be to ensure a mainline dictates the elevation of the start of a branch. +</li> +<li> +<strong>Station</strong> - assigns a name to the endpoint. +</li> +</ul> +<p> +<strong>Note:</strong> Only one of these attributes can be assigned to an endpoint at a time. For example, an endpoint can not be defined as a Grade and a Station at the same time. +</p> +<p> +When an endpoint is selected on the layout by <em>Left-Click</em>, it is highlighted by a large red dot and its elevation type and values are displayed in the dialog. +</p> +<p> +Additionally, <strong>Defined Elevation</strong> endpoints are indicated on the layout by gold colored dots. <strong>Ignored Elevation</strong> endpoints are indicated by blue colored dots. +</p> +<p> +The grade at the specified endpoint is displayed next to the <strong>Grade</strong> radio button. For <em>Defined Elevation</em> endpoints, the grade on each side of the endpoint is displayed. +</p> +<p> +<strong>Defined Elevation</strong> endpoints are used to specify fixed heights of track endpoints. Typically, this would be where a grade changes or where clearances must be maintained. <strong>Computed</strong> Elevations and <strong>Grade</strong> markers can place between <strong>Defined Elevation</strong> endpoints. These values are not entered directly but are computed dynamically based on <strong>Defined Elevations</strong> of connected tracks. This allows labeling of elevations at intermediate endpoints without having the enter specific values. <strong>Computed</strong> markers can also placed between a <strong>Defined Elevation</strong> point and the end of a track. +</p> +<p> +<strong>Stations</strong> are used to provide information for the Profile (<a href="cmdProfile.html#cmdProfile">Section 2.2.12</a>) command. +</p> +<p> +All <strong>Elevation</strong> labels (including <strong>Grade</strong> and <strong>Station</strong>) are drawn on the layout in outlined boxes. These may be moved by the <strong>Move Description</strong> (<a href="cmdMoveLabel.html#cmdMoveLabel">Section 2.2.10</a>) command. In addition, <strong>Grade</strong> labels have an arrow indicating the upwards direction. +</p> +<hr> +<ul> +<li><a href="computeElevations.html#computeElevations">2.2.5.1 Computing Dynamic Elevations</a></li> +</ul> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Computing Dynamic Elevations</title> +<link rel="previous" href="cmdElevation.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdFlip.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="computeElevations"></a>2.2.5.1 Computing Dynamic Elevations</h1> +<p> +Elevations of Tracks are computed in following steps. The colors listed in each step are used as the background color of the Track Elevation Markers (if they are enabled (<a href="cmdDisplay.html#cmdDisplay">Section 2.10.3</a>)). +</p> +<ul><li> +The Shortest Paths between all <em>Defined Elevations</em> are computed. A Path stops at <strong>Ignored</strong> or <em>Defined</em> endpoints. The Elevation of any Turnouts on these Paths with more than two connections are computed as the average Elevation inversely weighted by distance along the tracks to the <em>Defined Elevation</em> points (<em>Blue</em>). +</li> +</ul> +<p> + +</p> +<ul><li> +The Elevation of any other tracks on the Shortest Paths are computed based on the distance along the tracks from the Turnouts computed in the first step and/or the <em>Defined Elevation</em> points (<em>Purple</em>). +</li> +</ul> +<p> + +</p> +<ul><li> +The Elevation of any remaining tracks is computed based on the average Elevation of the tracks found in the first two steps that they are (directly or indirectly) connected to, inversely weighted by geometric distance (<em>Gold</em>). +</li> +</ul> +<p> + +</p> +<ul><li> +Any remaining tracks are not connected to a <em>Defined Elevation</em> and do not have an Elevation. +</li> +</ul> +<p> +The elevation computation is performed incrementally every time the layout is changed to keep all elevations in sync. The performance of the computation is affected by the placement of the <em>Defined Elevation</em> endpoints and the number of Paths between them. Place the <em>Defined Elevations</em> at points where tracks begin to branch (such as the throat of a yard or at the ends of a siding). Also, use <em>Defined Elevations</em> or <em>Ignore Elevations</em> to break the layout into areas so recomputation has fewer tracks and Paths to deal with. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Flip</title> +<link rel="previous" href="computeElevations.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdJoin.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdFlip"></a>2.2.6 Flip</h1> +<p> +<img src="png.d/bflip.png"> +</p> +<p> +This command turns selected objects over or around, effectively mirroring the object . +</p> +<ol><li> +Prior to invoking this command visualize how the selected object(s) will be flipped and determine where to draw a reference line that will act as an axis or anchor point for the flipped object(s). +<p> + +</p> +<dl><dd> +<img src="png.d/flip1.png"> <img src="png.d/flip2.png"> +</dd> +</dl> +<p> + +</p> + +</li> +<li> +Invoked the <strong>Flip</strong> command then <em>Left-Click</em> on one end of the reference line visualized in the proceeding step. Holding the <em>Left</em> mouse button, <em>Drag</em> the cursor across the layout to form the line visualized earlier. +<p> + +</p> +<dl><dd> +<img src="png.d/flip3.png"> <img src="png.d/flip4.png"> +</dd> +</dl> +<p> + +</p> + +</li> +<li> +Once a line of desired length and orientation appears, release the mouse button. The selected object(s) will then flip around the line as if it were a mirror. +</li> +</ol> +<p> +Since flipped objects are mirrored, turnout titles may be modified during the flip process. Right hand turnouts will become left hand turnouts and vice versa. Such is the case in this example. +</p> +<p> +Certain turnouts, such as a Wye's, Three-Way or Crossings are symmetrical and thus titles for this type of objects are not changed. If a title change is necessary the currently loaded <strong>Parameter Files</strong> (<a href="cmdPrmfile.html#cmdPrmfile">Section 2.5.7</a>) are searched for a turnout that matches the flipped turnout. If a match is not found, the turnout's title is prefixed with <strong>Flipped</strong>. The <strong>Properties</strong> (<a href="cmdDescribe.html#cmdDescribe">Section 2.2.13</a>) command be used to change the title of such turnouts. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Join Tracks and Lines</title> +<link rel="previous" href="cmdFlip.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdJoinLine.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdJoin"></a>2.2.7 Join Tracks and Lines</h1> +<p> +The <strong>Join</strong> command has two variatons, +</p> +<dl><dd> +(<a href="cmdJoinTrack.html#cmdJoinTrack">Section 2.2.7.2</a>). Join Tracks by connecting them. +</dd> +</dl> +<p> + +</p> +<dl><dd> +(<a href="cmdJoinLine.html#cmdJoinLine">Section 2.2.7.1</a>). Create a PolyLine from two Draw Objects or Close a PolyLine as a Polygon. +</dd> +</dl> +<hr> +<ul> +<li><a href="cmdJoinLine.html#cmdJoinLine">2.2.7.1 Join Lines</a></li> +<li><a href="cmdJoinTrack.html#cmdJoinTrack">2.2.7.2 Join Tracks</a></li> +<li><a href="joinNormalEasment.html#joinNormalEasment">2.2.7.3 Join with Normal Easement</a></li> +<li><a href="joinCornu.html#joinCornu">2.2.7.4 Join with Cornu Easement</a></li> +<li><a href="cornuTrackPins.html#cornuTrackPins">2.2.7.5 Cornu Track Pins</a></li> +<li><a href="joinTrackStraight.html#joinTrackStraight">2.2.7.6 Using Straight Flex-Track</a></li> +<li><a href="joinTrackMove.html#joinTrackMove">2.2.7.7 By Moving Track</a></li> +</ul> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Join Lines</title> +<link rel="previous" href="cmdJoin.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdJoinTrack.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdJoinLine"></a>2.2.7.1 Join Lines</h1> +<p> +<img src="png.d/bjoinline.png"> +</p> +<p> +The <strong>Join Line</strong> command produces a PolyLine from two Draw objects (Straight Line, Curved Line, Bezier Line or PolyLine). You select the two ends to join and the new Polyline will replace the two Draw objects, filling in any gap with a straight line segment. If the two ends are of the same PolyLine, an unfilled Polygon will be created. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Join Tracks</title> +<link rel="previous" href="cmdJoinLine.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="joinNormalEasment.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdJoinTrack"></a>2.2.7.2 Join Tracks</h1> +<p> +<img src="png.d/bjoin.png"> +</p> +<p> +The <strong>Join Track</strong> command is used to bring together and connect any two segments of track. During the join process, <em>XTrackCAD</em> ensures the connecting tracks are properly aligned. +</p> +<p> +See <strong>Help>Demo</strong> (<a href="cmdDemo.html#cmdDemo">Section 2.6.1</a>) for examples of how to join tracks. +</p> +<p> +For detail about; +</p> +<dl><dd> +Using complex curves if Easement is set to Cornu <a href="joinCornu.html#joinCornu">Section 2.2.7.4</a>. +</dd> +</dl> +<p> + +</p> +<dl><dd> +Using Normal Easements where tracks are either joined with a straight or a 'simple curve' <a href="joinNormalEasment.html#joinNormalEasment">section 2.2.7.3</a>, e.g. one which uses a curve in a single direction as opposed to using a S-Curve (<a href="generalTerms.html#generalTerms">Section B.2</a>) +</dd> +</dl> +<p> + +</p> +<dl><dd> +Using straight flex-track to join track segments refer to <a href="joinTrackStraight.html#joinTrackStraight">Section 2.2.7.6</a>. +</dd> +</dl> +<p> + +</p> +<dl><dd> +Moving one segment of track to join with another refer to <a href="joinTrackMove.html#joinTrackMove">Section 2.2.7.7</a>. +</dd> +</dl> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Join with Normal Easement</title> +<link rel="previous" href="cmdJoinTrack.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="joinCornu.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="joinNormalEasment"></a>2.2.7.3 Join with Normal Easement</h1> +<p> +This type of join does not work for Bezier or Cornu tracks, use Cornu Easements (<a href="joinCornu.html#joinCornu">Section 2.2.7.4</a>) for these tracks instead. +</p> +<p> + +</p> +<dl><dd> +<img src="png.d/joincrv1.png"> +</dd> +</dl> +<p> + +</p> +<ol><li> +Start the join process by clicking on the Join button (<img src="png.d/bjoin.png">). +<p> + +</p> +<p> +<img src="png.d/joincrv2.png"> +</p> +<p> + +</p> + +</li> +<li> +<em>Left-Click</em> the endpoint of one of the two tracks being joined. A red dot will appear as a reminder of which track has been selected. +<p> + +</p> +<p> +<img src="png.d/joincrv4.png"> +</p> +<p> + +</p> + +</li> +</ol> +<p> +After the first track is selected, an entry field for prefered radius will be shown. A non-zero value will enable the snap anchor for the join radius. +</p> +<ol><li> +Move the mouse pointer over the endpoint of the other track then <em>Left-Click</em> and hold the mouse button down. A track connecting the two endpoints will appear. +<p> +If the track appears in black (and you are happy with the curve as its drawn), release the mouse button. +</p> +<p> +If the radius snap-anchor is active, and the position of the cursor is close to a position where the Join is exactly the desired radius, a blue circle will be shown. Releasing the button while it shows will snap the Join to the desired radius. If Easements are enabled as well, this fixed radius Join track will be joined to by easements. +</p> +<p> + +</p> +<p> +<img src="png.d/joincrv3.png"> +</p> +<p> + +</p> + +</li> +<li> +If the track appears in red, it means <em>XTrackCAD</em> can't determine how to connect the first track with the second. If this occurs, while holding the left mouse button, drag the mouse back toward the first track until the connecting track appears in black. If the connecting track remains red, drag the mouse in the opposite direction until the connecting track turns black. Once the connecting track turns black, release the mouse button to finalize the <em>Join</em> command. +<p> + +</p> +<p> +<img src="png.d/joincrv5.png"> +</p> +<p> + +</p> + +</li> +</ol> +<p> +Throughout the above, the exact shape of the curve can be adjust by dragging the mouse around while keeping the left mouse button held down. +</p> +<p> +Sometimes, no matter where you drag the mouse, the curve stays red and the tracks cannot be connected. This means the resulting curve is tighter than the minimum track radius set in the <em>Preferences dialog</em> (<a href="cmdPref.html#cmdPref">Section 2.10.7</a>). If desired, this setting can be adjusted from the <em>Preferences dialog</em> using the <strong>Options>Preferences</strong> menu selection to raise the dialog. If changing the minimum track radius is not a desired option then it will be necessary to relocate one of the tracks that you're attempting to join. +</p> +<p> +You may also find that <em>XTrackCAD</em> will not create the connecting curve in the exact shape you want. If this happens it may be necessary to either move one of the end points or draw a partial curve (or straight) and try again. +</p> +<p> +If enabled, Easements (<a href="cmdEasement.html#cmdEasement">Section 2.10.4</a>) will be automatically generated between tracks of differing radii. When using easements, there is a minimum radius as specified in the <em>Easement</em> dialog. It's not possible to join tracks with less then this radius and the connecting track's radius must be greater than the minimum radius. +</p> +<p> +If any errors occur while joining tracks (such as moving beyond the end of a track or using a curve with a radius smaller than the Easement radius), then the joint track will be drawn in Red (The default colour of Exception Track errors. See <a href="cmdRgbcolor.html#cmdRgbcolor">Section 2.10.1</a> for detail). This colouring serves as visual indication for a connecting track that doesn't meet minimum specified parameters (<a href="cmdPref.html#cmdPref">Section 2.10.7</a>). +</p> +<p> +Any tracks created during the <strong>Join</strong> command will have the following properties inherited from the first track: selected state, hidden state, scale, track gauge and Layer. +</p> +<p> +A join can be made to or from a circle (<a href="cmdCircle.html#cmdCircle">Section 2.1.1</a>) of track. Joining a track with a circle will cause the circle to be converted into a curved track. +</p> +<p> +For detail about; +</p> +<dl><dd> +Using straight flex-track to join track segments refer to <a href="joinTrackStraight.html#joinTrackStraight">Section 2.2.7.6</a>. +</dd> +</dl> +<p> + +</p> +<dl><dd> +Moving one segment of track to join with another refer to <a href="joinTrackMove.html#joinTrackMove">Section 2.2.7.7</a>. +</dd> +</dl> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Join with Cornu Easement</title> +<link rel="previous" href="joinNormalEasment.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cornuTrackPins.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="joinCornu"></a>2.2.7.4 Join with Cornu Easement</h1> +<p> +<a name="i0"></a>Creating a Cornu <a name="i1"></a>Modifying a Cornu <a name="i2"></a>Cornu Easements +</p> +<p> +A Cornu is a form of curve that uses a mathematical approach to creating a curve between two sets of end conditions. +</p> +<p> +The curve is designed to change curvature linearly along its length - which is the characteristic of a railway easement because it minimizes sudden changes in acceleration towards the center of curvature. +</p> +<p> +The conditions used at each end are the radius, angle and position. +</p> +<p> +Cornus can have added constraints in the form of track "pins" that force the curve to smoothly pass through that point while still respecting the end conditions. +</p> +<p> +Cornus can be used in XtrackCAD to both Join tracks smoothly and form smooth curves that are not joined to other tracks. +</p> +<p> +Because Cornu are mathematically generated, they can also be regenerated at will and so Cornu Joins have the unique characteristic in XTrackCAD that they remain connected even if the tracks at the ends are moved or even change shape. +</p> +<p> +Cornu Joins will use whatever space is available - that is their "tightness" (rate of change of curvature) is variable and dynamic. The minimum radius is calculated and will show as an exception, but the acceptable rate of change of curvature is the choice of the designer. +</p> +<p> +It is not always the case that the Cornu will be the most efficient way to get from A to B - because of its shape it will be the smoothest. If you want to bias the result, you can add TrackPins (<a href="cornuTrackPins.html#cornuTrackPins">Section 2.2.7.5</a>). +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Cornu Track Pins</title> +<link rel="previous" href="joinCornu.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="joinTrackStraight.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cornuTrackPins"></a>2.2.7.5 Cornu Track Pins</h1> +<p> +XTrackCAD Cornu can have "track pins" added that constrain the track to pass through those points in addition to meeting the end-conditions. This allows the track to be skewed or slewed around obstacles, or to suit some other constraint. +</p> +<p> +The pins can be added when Cornus are created <a href="cmdCornu.html#cmdCornu">Section 2.1.2.6</a> or during <a href="cmdModify.html#cmdModify">Section 2.2.8</a> after clicking on the track. They can be selected and then <code>Left-Drag</code> dragged to alter the curve shape or deleted with <code>Delete</code>. +</p> +<p> +When a Cornu Track with pins is saved, it is split into two Cornu joined at the pin. If a Cornu that is joined to another Cornu is Modified with <a href="cmdModify.html#cmdModify">Section 2.2.8</a>, the joints are rendered as Pins and the Modify is done for one continuous Cornu. +</p> +<p> + +</p> +<ol><li> +First, ensure that the Easement type option is set to Cornu - see <a href="cmdEasement.html#cmdEasement">section 2.10.4</a> +</li> +<li> +Start the Join Track process by clicking on the Join Track button (<img src="png.d/bjoin.png">). +</li> +</ol> +<p> +As you move over tracks a blue roundel will indicate the end that will be chosen with <em>Left-Click</em>. +</p> +<p> +<img src="png.d/joincornu1.png"> +</p> +<dl><dd> +<code>Left-Click</code> the open endpoint of one of the two tracks being joined. A red dot within a red circle will appear at the end of the join. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<code>Left-Drag</code> the endpoint to where you want it and release the button. The point will only move along the piece of track with the open endpoint (if this track type can be split) as far as the opposite end, or as an extension of that track at the selected end with the same curvature (if this track can be extended). Note that you will be able to fine-tune the end positions later. +<p> + +</p> +<p> +<img src="png.d/joincornu2.png"> +</p> +<p> + +</p> + +</dd> +<dd> +<code>Left-Click</code> the endpoint of the other track being joined. Another red dot within a circle will appear at that end of the join. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<code>Left-Drag</code> the endpoint to where you want it and release the button. The second endpoint can only be moved along the second track as far as the other end (if it can be split) or as an extension beyond the end of this track (if it can be extended). The initial curve will be drawn - it will be red if the minimum radius is smaller than the minimum radius option. +<p> + +</p> +<p> +<img src="png.d/joincornu3.png"> +</p> +<p> + +</p> + +</dd> +<dd> +You are now in "Select Points" mode. +</dd> +</dl> +<p> + +</p> +<dl><dd> +You can select one end point at a time with <code>Left-Click</code> and move it with <code>Left-Drag</code>. If you drag the end point off the original track it will extend. +</dd> +</dl> +<p> + +</p> +<dl><dd> +You can select a pin by <code>Left-Click</code>ing on it and move it with <code>Left-Drag</code>. <code>Delete</code> will remove the last selected Pin. +</dd> +</dl> +<p> + +</p> +<dl><dd> +You can add a Pin by <code>Left-Click</code>ing on an area of the track with no Pin or end. +</dd> +</dl> +<p> + +</p> +<dl><dd> +Once you are happy, hit <em>Enter</em> or the <em>SpaceBar</em> to finish editing the easement. Or hit <em>Esc</em> to cancel. +</dd> +<dd> +If you want to modify the Cornu later (even if it is joined at both ends) see <a href="chgCornu.html#chgCornu">section 2.2.8.8</a> +</dd> +</dl> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Using Straight Flex-Track</title> +<link rel="previous" href="cornuTrackPins.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="joinTrackMove.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="joinTrackStraight"></a>2.2.7.6 Using Straight Flex-Track</h1> +<p> +This method of joining track may be used where the endpoints of the two tracks to be joined are on the same horizontal (<code>X</code>) or vertical (<code>Y</code>) axis. +</p> +<p> + +</p> +<dl><dd> +<img src="png.d/joinstrt1.png"> +</dd> +</dl> +<p> + +</p> +<ol><li> +Start the join process by clicking on the Join button (<img src="png.d/bjoin.png">). +<p> + +</p> +<p> +<img src="png.d/joinstrt2.png"> +</p> +<p> + +</p> + +</li> +<li> +<em>Left-Click</em> the endpoint of one of the two tracks being joined. A red dot will appear as a reminder of which track has been selected. +<p> + +</p> +<p> +<img src="png.d/joinstrt3.png"> +</p> +<p> + +</p> + +</li> +<li> +Move the mouse pointer over the endpoint of the other track then <em>Left-Click</em>. A track connecting the two endpoints will appear. +</li> +</ol> +<p> +When this command is used to join; +</p> +<ul><li> +two flex-track endpoints, one long section of flex-track without joints will result. +</li> +<li> +two sectional track endpoints, a section of flex-track will be created between and used to join the two sectional track endpoints. +</li> +<li> +one flex-track endpoint with one sectional track endpoint, the section of flex-track will be extended and joined with the sectional track endpoint. +</li> +</ul> +<p> +Any tracks created during the <strong>Join</strong> command will have the following properties inherited from the first track: selected state, hidden state, scale, track gauge and Layer. +</p> +<p> +Turnouts and Sectional (<a href="cmdHotBar.html#cmdHotBar">Section 2.7</a>) tracks can be joined to other tracks. <em>XTrackCAD</em> extends the selected endpoint with a straight track when making the connection. +</p> +<p> +A Turntable (<a href="cmdTurntable.html#cmdTurntable">Section 2.1.9</a>) can be joined however it must be used as the second endpoint for normal easements but can be connected to either end with Cornu. +</p> +<p> +For detail about; +</p> +<dl><dd> +Using curved flex-track to join track segments refer to <a href="joinCornu.html#joinCornu">Section 2.2.7.4</a>. +</dd> +</dl> +<p> + +</p> +<dl><dd> +Moving one segment of track to join with another refer to <a href="joinTrackMove.html#joinTrackMove">Section 2.2.7.7</a>. +</dd> +</dl> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>By Moving Track</title> +<link rel="previous" href="joinTrackStraight.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdModify.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="joinTrackMove"></a>2.2.7.7 By Moving Track</h1> +<p> +This method of joining track may be used to move, align and join one section of track with another. +</p> +<p> + +</p> +<dl><dd> +<img src="png.d/joinmove1.png"> +</dd> +</dl> +<p> + +</p> +<ol><li> +Before initiating the <strong>Join</strong> command, the track that will be moved, aligned and then joined must be selected using the <strong>Select</strong> command (<a href="cmdSelect.html#cmdSelect">Section 2.2.16</a>). +<p> + +</p> +<p> +<img src="png.d/joinmove2.png"> +</p> +<p> + +</p> + +</li> +<li> +Once the track to be moved is selected, start the join process by clicking on the Join button (<img src="png.d/bjoin.png">). +<p> + +</p> +<p> +<img src="png.d/joinmove3.png"> +</p> +<p> + +</p> + +</li> +<li> +<em>Shift+Left-Click</em> the endpoint of one of the two tracks being joined. A red dot will appear as a reminder of which track has been selected. +<p> + +</p> +<p> +<img src="png.d/joinmove4.png"> +</p> +<p> + +</p> + +</li> +<li> +Then move the mouse pointer over the endpoint of the other (unselected and stationary) track with <em>Shift+Left-Click</em>. The selected track will be moved, aligned then joined to the stationary section of track. +</li> +</ol> +<p> +For detail about; +</p> +<dl><dd> +Using curved flex-track to join track segments refer to <a href="joinCornu.html#joinCornu">Section 2.2.7.4</a>. +</dd> +</dl> +<p> + +</p> +<dl><dd> +Using straight flex-track to join track segments refer to <a href="joinTrackStraight.html#joinTrackStraight">Section 2.2.7.6</a>. +</dd> +</dl> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Modify</title> +<link rel="previous" href="joinTrackMove.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="extendModify.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdModify"></a>2.2.8 Modify</h1> +<p> +<img src="png.d/bmodify.png"> +</p> +<p> +The <strong>Modify</strong> command is used to change characteristics of tracks or draw elements or extend existing track by adding new track. The extend type of Modify command works with any unconnected track endpoint, or with <em>Turntables</em>. <em>Cornu(s)</em> or <em>Bezier</em> track can be modified even if connected. Selecting one Cornu which is connected to other Cornu(s) results in a single modification curve with control "Pins" at the connections. +</p> +<p> +The <strong>Modify</strong> command can be invoked using the <strong>Change>Modify</strong> menu item, the <strong>Modify</strong> button, by <em>Double-Click</em> in Select when hovering over a selected item or the menu raised by a <em>Right-Click</em> over the <strong>Main Canvas</strong>. +</p> +<p> +Before a track is selected for Modify, a dynamic blue anchor will show which track the command will take effect on if the cursor is close enough to a modifyable track or object. Arrows are shown to indicate if the track can be extended or trimmed and also if its radius can be modified if Shift is depressed as the cursor is moved over the track. +</p> +<ul> +<li><a href="extendModify.html#extendModify">2.2.8.1 Extending Track</a></li> +<li><a href="objectModify.html#objectModify">2.2.8.2 Modifying Objects</a></li> +<li><a href="chgTrackLength.html#chgTrackLength">2.2.8.3 Changing Track Length</a></li> +<li><a href="createTangent.html#createTangent">2.2.8.4 Creating a Tangent to a Curve</a></li> +<li><a href="chgTrackRadius.html#chgTrackRadius">2.2.8.5 Changing Track Radius</a></li> +<li><a href="extendTrack.html#extendTrack">2.2.8.6 Extending Track Length</a></li> +<li><a href="chgDraw.html#chgDraw">2.2.8.7 Modifying Draw Elements</a></li> +<ul> +<li><a href="polyModify.html#polyModify">2.2.8.7.1 Modifying PolyLines and Polygons</a></li> +</ul> +<li><a href="chgCornu.html#chgCornu">2.2.8.8 Cornu Easements Modifying a Cornu Track</a></li> +<li><a href="chgBezier.html#chgBezier">2.2.8.9 Modifying a Bezier</a></li> +</ul> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Extending Track</title> +<link rel="previous" href="cmdModify.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="objectModify.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="extendModify"></a>2.2.8.1 Extending Track</h1> +<p> +Either the left mouse button (for changing length or creating a tangent track) or the right mouse button (for extending with a new track) is used to modify an unconnected endpoint. +</p> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Modifying Objects</title> +<link rel="previous" href="extendModify.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="chgTrackLength.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="objectModify"></a>2.2.8.2 Modifying Objects</h1> +<ol><li> +The endpoints of a <em>Line</em>, <em>Dimension Line</em>, <em>Table Edge</em> or <em>Benchwork</em> can be dragged to new positions. +</li> +<li> +The ends of a <em>Ruler</em> or the ends and origin of a <em>Protractor</em> can be dragged to new positions +</li> +<li> +A <em>Box</em> or a <em>FilledBox</em> can be modified by selecting a corner and dragging in two dimensions, or a side and dragging it orthogonally. This modifications preserve a 4-sided rectangle. +</li> +<li> +The controlpoints of a <em>Cornu Track</em>, <em>Bezier Track</em> or <em>Bezier Line</em> can be changed. Control "Pins" can be added, moved or selected and removed from <em>Cornus</em>. +</li> +<li> +<em>Curved Lines</em> are modified by dragging the end points and dragging the amount of central deflection (radius). +</li> +</ol> +<p> +Any tracks created during the <strong>Modify</strong> command will have the following properties inherited from the first track: selected state, hidden state, scale, track gauge and Layer. +</p> +<p> +For more detail about; +</p> +<dl><dd> +Changing track length refer to <a href="chgTrackLength.html#chgTrackLength">Section 2.2.8.3</a>. +</dd> +</dl> +<p> + +</p> +<dl><dd> +Creating a tangent to a curve refer to <a href="createTangent.html#createTangent">Section 2.2.8.4</a> +</dd> +</dl> +<p> + +</p> +<dl><dd> +Changing track radius refer to <a href="chgTrackRadius.html#chgTrackRadius">Section 2.2.8.5</a> +</dd> +</dl> +<p> + +</p> +<dl><dd> +Extending track length refer to <a href="extendTrack.html#extendTrack">Section 2.2.8.6</a> +</dd> +</dl> +<p> + +</p> +<dl><dd> +Modifying Draw elements refer to <a href="chgDraw.html#chgDraw">Section 2.2.8.7</a> +</dd> +</dl> +<p> + +</p> +<dl><dd> +Modifying Polygons and PolyLines refer to <a href="polyModify.html#polyModify">Section 2.2.8.7.1</a> +</dd> +</dl> +<p> + +</p> +<dl><dd> +Modifying a Cornu refer to <a href="chgCornu.html#chgCornu">Section 2.2.8.8</a> +</dd> +</dl> +<p> + +</p> +<dl><dd> +Modifying a Bezier refer to <a href="chgBezier.html#chgBezier">Section 2.2.8.9</a> +</dd> +</dl> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Changing Track Length</title> +<link rel="previous" href="objectModify.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="createTangent.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="chgTrackLength"></a>2.2.8.3 Changing Track Length</h1> +<ol><li> +Click the <strong>Modify</strong> button (<img src="png.d/bmodify.png">) to activate the <strong>Modify</strong> function. +<p> + +</p> + +</li> +<li> +With the mouse pointer hovering over the endpoint of the object to be modified, <em>Left+Drag</em> (<a href="windowTerms.html#windowTerms">Section B.1</a>) to change the length of the track segment, table edge, bench-work, dimension line or line. If <strong>MagneticSnap</strong> is enabled, the end will snap to any close draw object. <code>Alt</code> inverts the MagneticSnap setting. If there is no nearby object and <strong>SnapGrid</strong> is enabled, the end will snap to a grid point unless <strong>Alt</strong> is added. +<p> + +</p> + +</li> +</ol> +<p> +<em>Left+Drag</em>ging the endpoint of a turnout (or other sectional track) causes a straight length of flex-track to be created from the selected endpoint to the cursor. +</p> +<p> +<em>Left+Drag</em>ging the endpoint of a <strong>Table Edge</strong> (<a href="cmdDraw.html#cmdDraw">Section 2.3</a>) allows the endpoint to be moved to a new position. If <code>Ctrl</code> is added and the endpoint is moved close to another <strong>Table Edge</strong> then the endpoint will be moved to it if not, the line will be a multiple of 90 degrees. +</p> +<p> +The length of a curved track can be changed to form an almost complete circle by selecting one endpoint of the curved track then dragging the cursor to the other endpoint. Going past the other endpoint creates a very small curve. Curves greater than 360° cannot be created. +</p> +<p> +For detail about; +</p> +<dl><dd> +Creating a tangent to a curve refer to <a href="createTangent.html#createTangent">Section 2.2.8.4</a> +</dd> +</dl> +<p> + +</p> +<dl><dd> +Changing track radius refer to <a href="chgTrackRadius.html#chgTrackRadius">Section 2.2.8.5</a> +</dd> +</dl> +<p> + +</p> +<dl><dd> +Extending track length refer to <a href="extendTrack.html#extendTrack">Section 2.2.8.6</a> +</dd> +</dl> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Creating a Tangent to a Curve</title> +<link rel="previous" href="chgTrackLength.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="chgTrackRadius.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="createTangent"></a>2.2.8.4 Creating a Tangent to a Curve</h1> +<ol><li> +Click the <strong>Modify</strong> button (<img src="png.d/bmodify.png">) to activate the <strong>Modify</strong> function. +<p> + +</p> + +</li> +<li> +With the mouse pointer hovering over the endpoint of the object to be modified, <em>Left+Drag</em> (<a href="windowTerms.html#windowTerms">Section B.1</a>) to change the length of the track segment. +</li> +</ol> +<p> +If a <em>Left+Drag</em> is continued beyond the radius of a curved track (<a href="cmdCurve.html#cmdCurve">Section 2.1.2</a>) (not a Circle) a tangent to the curve will be created. +</p> +<p> +Creation of the tangent begins when the distance from the curved track center to the cursor is greater than 110% of the radius. If the cursor is moved within the radius of the curve then the current command exits and the <em>Changing Track Length</em> (<a href="chgTrackLength.html#chgTrackLength">Section 2.2.8.3</a>) command is executed instead. +</p> +<p> +If <strong>Easements</strong> (<a href="cmdEasement.html#cmdEasement">Section 2.10.4</a>) are enabled then an easement curve will be generated (if required) to connect the old and new tracks. +</p> +<p> +For detail about; +</p> +<dl><dd> +Changing track length refer to <a href="chgTrackLength.html#chgTrackLength">Section 2.2.8.3</a>. +</dd> +</dl> +<p> + +</p> +<dl><dd> +Changing track radius refer to <a href="chgTrackRadius.html#chgTrackRadius">Section 2.2.8.5</a> +</dd> +</dl> +<p> + +</p> +<dl><dd> +Extending track length refer to <a href="extendTrack.html#extendTrack">Section 2.2.8.6</a> +</dd> +</dl> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Changing Track Radius</title> +<link rel="previous" href="createTangent.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="extendTrack.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="chgTrackRadius"></a>2.2.8.5 Changing Track Radius</h1> +<p> +This command is used to change the radius of a curved track or to curve a section of straight track. +</p> +<ol><li> +Click the <strong>Modify</strong> button (<img src="png.d/bmodify.png">) to activate the <strong>Modify</strong> function. +<p> + +</p> + +</li> +<li> +<em>Shift+Left+Drag</em> the unconnected endpoint of a curved track to change the radius of track segment. Alternately, <em>Shift+Left+Drag</em> the unconnected endpoint of a straight track to add a radius to the track segment. +<p> + +</p> +<ul><li> +For this command to work, the endpoint opposite that being manipulated must be connected to another track. +</li> +</ul> +<p> + +</p> + +</li> +</ol> +<p> +This command can be used to change straight tracks into curved track and vice versa. +</p> +<p> +For detail about; +</p> +<dl><dd> +Changing track length refer to <a href="chgTrackLength.html#chgTrackLength">Section 2.2.8.3</a>. +</dd> +</dl> +<p> + +</p> +<dl><dd> +Creating a tangent to a curve refer to <a href="createTangent.html#createTangent">Section 2.2.8.4</a> +</dd> +</dl> +<p> + +</p> +<dl><dd> +Extending track length refer to <a href="extendTrack.html#extendTrack">Section 2.2.8.6</a> +</dd> +</dl> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Extending Track Length</title> +<link rel="previous" href="chgTrackRadius.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="chgDraw.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="extendTrack"></a>2.2.8.6 Extending Track Length</h1> +<p> +This command is used to extend the length of a straight or curved section of track. +</p> +<ol><li> +Click the <strong>Modify</strong> button (<img src="png.d/bmodify.png">) to activate the <strong>Modify</strong> function. +<p> + +</p> + +</li> +<li> +With the mouse pointer hovering over the endpoint of the object to be modified, <em>Right+Drag</em> (<a href="windowTerms.html#windowTerms">Section B.1</a>) to extend the length of the track segment. +<p> + +</p> + +</li> +</ol> +<p> +The selected endpoint determines the position and angle of the first endpoint of the new track. The cursor is dragged to set the second endpoint. A curved or straight track will be created, depending on the position of the second endpoint. +</p> +<p> +If <strong>easements</strong> (<a href="cmdEasement.html#cmdEasement">Section 2.10.4</a>) are enabled then an easement curve will be generated (if required) to connect the old and new tracks. +</p> +<p> +For detail about; +</p> +<dl><dd> +Changing track length refer to <a href="chgTrackLength.html#chgTrackLength">Section 2.2.8.3</a>. +</dd> +</dl> +<p> + +</p> +<dl><dd> +Creating a tangent to a curve refer to <a href="createTangent.html#createTangent">Section 2.2.8.4</a> +</dd> +</dl> +<p> + +</p> +<dl><dd> +Changing track radius refer to <a href="chgTrackRadius.html#chgTrackRadius">Section 2.2.8.5</a> +</dd> +</dl> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Modifying Draw Elements</title> +<link rel="previous" href="extendTrack.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="polyModify.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="chgDraw"></a>2.2.8.7 Modifying Draw Elements</h1> +<p> +Draw elements have blue handles that show how they can be modified. They also have text entry boxes that allow precise entry of parameters. These values become active when a <em>Tab</em> is entered, or the cursor is moved out of the text box. +</p> +<p> +There is a context menu accessed via <em>Right-Click</em> for Draw Objects that can change the edit mode from the initial "Points Mode" to "Origin Mode" where <em>Click</em> sets the position of the drawn object's origin - which will cause subsequent rotations using <a href="cmdModify.html#cmdModify">Section 2.2.8</a> or <a href="cmdDescribe.html#cmdDescribe">Section 2.2.13</a> to be centered about that point. +</p> +<p> +The context menu can be used to go back to Points Mode, or to set the origin to one of a number of defined points. There are text shortcuts - "o" for Origin Mode and "p" for Points Mode. +</p> +<p> +In Origin Mode, the context menu allows the origin to be set to be - +</p> +<dl><dd> +<em>Absolute</em> (shortcut "0") with the origin at the layout origin or +</dd> +<dd> +<em>Relative</em> by dragging the origin to a point, or snapping to the position of the first 4 corner points (shortcut "1" through "4"), or to the middle/centroid of the shape (shortcut "m"). For a Polygon or Polyline the <em>Relative</em> origin can be snapped to a last selected node (shortcut "l"). +</dd> +</dl> +<p> + +</p> +<p> +In Points Mode, +</p> +<p> + +</p> +<dl><dd> +Lines have end points that can be dragged. <em>Shift-Drag</em> will snap the end to the end of a nearby Draw object, while <em>Ctrl+Drag</em> will snap to any point on a nearby Draw object. They have text entry boxes for length and angle. +</dd> +</dl> +<p> + +</p> +<dl><dd> +Curves have end points that work like Lines but also have a middle anchor that can be used to alter the curve radius. They have text box entry for Arc Length (in degrees) and Radius. +</dd> +</dl> +<p> + +</p> +<dl><dd> +Boxes have anchors for all corners and the middle of all sides. They have text entry boxes for width and height. +</dd> +</dl> +<p> + +</p> +<dl><dd> +Bezier Lines - see <a href="chgBezier.html#chgBezier">Section 2.2.8.9</a> +</dd> +</dl> +<ul> +<li><a href="polyModify.html#polyModify">2.2.8.7.1 Modifying PolyLines and Polygons</a></li> +</ul> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Modifying PolyLines and Polygons</title> +<link rel="previous" href="chgDraw.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="chgCornu.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="polyModify"></a>2.2.8.7.1 Modifying PolyLines and Polygons</h1> +<p> +When a Polygon or a PolyLine is modified, open blue circle anchors show the position of its "nodes", these are selected with <strong>Left-Click</strong> and are shown as filled circles. +</p> +<ul><li> +<strong>Left-Drag</strong> of a selected node of a <em>PolyLine</em> or <em>Polygon</em> moves that node to a new position, and if moved close enough to a neighboring node will merge the two nodes and delete the edge between them. +</li> +</ul> +<p> + +</p> +<ul><li> +<strong>Delete</strong> or <strong>Backspace</strong> will remove a selected node. +</li> +</ul> +<p> + +</p> +<ul><li> +<strong>Left-Clicking</strong> on an edge will create a new node that can be dragged to position it. +</li> +</ul> +<p> + +</p> +<ul><li> +Multiple points can be selected using <strong>Shift+Left-Click</strong>. If these are then <strong>Left-Drag</strong>ed all the selected points move together, preserving relative position. +</li> +</ul> +<p> + +</p> +<ul><li> +There is a context menu that has controls for a selected point. It has options to alter the node into a rounded node (shortcut "r") or a smooth node (shortcut "s"). To turn it back into a sharp (vertex) node (shortcut "v"). +</li> +</ul> +<p> + +</p> +<ul><li> +If <em>Shift</em> is held down while dragging, the relative angle for the first selected point to its predecessor point will be locked to a multiple of 90 degrees. +</li> +</ul> +<p> + +</p> +<ul><li> +When a node or nodes is/are selected, text entry boxes for length and relative angle (the deviation angle from the direction of preceeding side) can be used to fine-tune the position of the first node in the sequence. A arc indicator identifies the angle in question. +</li> +</ul> +<p> + +</p> +<p> +If no nodes are selected, +</p> +<p> + +</p> +<ul><li> +A context menu can be used to close a polyline into a polygon (shortcut "g") or open it (shortcut "l") into a non-filled polygon between its last and first nodes. +</li> +</ul> +<p> + +</p> +<ul><li> +A unfilled polygon can also be filled (shortcut "f") or a filled one emptied (shortcut "u"). +</li> +</ul> +<p> + +</p> +<p> +Notes +</p> +<p> + +</p> +<dl><dd> +A selected Polygon or Polyline node can only be deleted if there are at least three nodes left. It can only be round or smooth if long as it isn't an end node of a Polyline. +</dd> +</dl> +<p> + +</p> +<dl><dd> +Smoothed nodes implement a short Bezier curve that goes from halfway along the line of to the next node and which has a control arm that ends at the node. These are typically of most use to fine-tune a series of nodes that simulate a complex curve. +</dd> +</dl> +<p> + +</p> +<dl><dd> +Rounded nodes start at a distance that is half the shorter of the lines from the last node and to the next node and has control arms that extend to the half-way point to the node. This produces an arc whose radius is determined by the distance of the closet node. By manipulating the nearest node (for example, by adding a point) the radius at the node can be controlled. +</dd> +</dl> +<p> + +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Cornu Easements Modifying a Cornu Track</title> +<link rel="previous" href="polyModify.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="chgBezier.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="chgCornu"></a>2.2.8.8 <a name="i0"></a>Cornu Easements Modifying a Cornu Track</h1> +<p> +Because a Cornu Track is defined by its end points position, angle and radius - it can only be directly modified by dragging an end point along a track, or altering its end conditions if it is not joined to another track. It can also have added "Pins" which constrain the curve to smoothly pass through a point. +</p> +<ol><li> +Click the <strong>Modify</strong> button (<img src="png.d/bmodify.png">) to activate the <strong>Modify</strong> function. +<p> + +</p> + +</li> +<li> +Click on the Cornu track. The track ends will turn into roundels. If any other Cornus are connected at either end, the entire connected set will be modifyable as one Cornu with intermediate "Pins" at the connections. +<p> + +</p> + +</li> +<li> +<em>Left-Click</em> an endpoint and <em>Left-Drag</em> it to move the endpoint along a connected track, or beyond it if you want that track extended. If there is no track the endpoint is free to move. +<p> + +</p> + +</li> +<li> +For an unconnected end point, <em>Left-Click</em> on the Radius or Angle anchors and <em>Left-Drag</em> it to adjust them. +<p> + +</p> + +</li> +<li> +<em>Left-Click</em> an Pin and <em>Left-Drag</em> it to move the pin and make the curve to pass through it. +<p> + +</p> + +</li> +<li> +<em>Left-Click</em> the track where a Pin doesn't exist to add a Pin and <em>Left-Drag</em> it to alter the curve to pass through a defined point. +<p> + +</p> + +</li> +<li> +<em>Delete</em> to delete the last seelcted Pin, the curve will change to meet the end conditions and pass through any remaining Pins. +<p> + +</p> + +</li> +<li> +Repeat with the other end-point or Pins if desired +<p> + +</p> + +</li> +<li> +Once you are happy, hit the <em>spacebar</em> or <em>Enter</em>, or to cancel hit <em>Escape</em>. +</li> +</ol> +<p> +<strong>Note:</strong> If the Modify command contained Pins, <em>spacebar</em> or <em>Enter</em> it will output a set of connected Cornu(s) joined at the Pin points. +</p> +<p> +<strong>Note:</strong> A Cornu can also be modified by moving or rotating a connected track. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Modifying a Bezier</title> +<link rel="previous" href="chgCornu.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdMove.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="chgBezier"></a>2.2.8.9 Modifying a Bezier</h1> +<p> +Because a Bezier is defined by its control points position - its shape can only be modified by dragging an control point. +</p> +<ol><li> +Click the <strong>Modify</strong> button (<img src="png.d/bmodify.png">) to activate the <strong>Modify</strong> function. +<p> + +</p> + +</li> +<li> +Click on the track. The control points will appear +<p> + +</p> + +</li> +<li> +<em>Left-Click</em> a control point and <em>Left-Drag</em> it to move it. +<p> + +</p> + +</li> +<li> +Repeat for another end point if desired +<p> + +</p> + +</li> +<li> +Once you are happy, hit the <em>spacebar</em> or <em>Enter</em>, or to cancel hit <em>Escape</em>. +</li> +</ol> +<p> +<strong>Note: </strong> A Bezier's end point will only be modifyable if it is not connected. Both internal control points can be modified even if the track is connected. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Move</title> +<link rel="previous" href="chgBezier.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="moveByMouse.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdMove"></a>2.2.9 Move</h1> +<p> +<img src="png.d/bmove.png"> +</p> +<p> +This command is used to move selected (<a href="cmdSelect.html#cmdSelect">Section 2.2.16</a>) objects around the layout. +</p> +<p> +The <strong>Move</strong> command can be invoked using the <strong>Change>Move</strong> menu item or the <strong>Move</strong> button and from the menu that's raised by a <em>Right-Click</em> over the <strong>Main Canvas</strong> or by the <em>Shift+Left+Drag</em> command when in <strong>Select</strong> mode. +</p> +<p> +Successful use of this command requires selection of the object(s) to be moved before attempting to move it. An object is selected by using the <em>Left-Click</em> command. A group of connected objects can be selected using the <em>Shift+Left-Click</em> command. +</p> +<p> +A move can be achieved using one of the following methods; +</p> +<p> + +</p> +<dl><dd> +<em>Left+Drag</em> using the mouse. See <a href="moveByMouse.html#moveByMouse">Section 2.2.9.1</a> for detail. +</dd> +</dl> +<p> + +</p> +<dl><dd> +Selecting fixed or specified amounts of translation in the X and Y directions using a <em>Right-Click</em> menu. See <a href="moveByMenu.html#moveByMenu">Section 2.2.9.2</a> for detail. +</dd> +</dl> +<p> + +</p> +<p> +During a Move of tracks, and <strong>MagneticSnap</strong> (<a href="cmdMagneticSnap.html#cmdMagneticSnap">Section 2.12.1</a>) is enabled, if one of the end-points of the selected objects is close to an open end of a unselected point, two anchors (an open an closed blue ball) will appear. This indicates that the two points will auto-join and that all the moved tracks will align to the unselected point if the Move is stopped. This behaviour can be suppressed with <em>Alt</em>. If <strong>MagneticSnap</strong> is disabled, the alignment will only occur if <em>Alt</em> is pressed. +</p> +<hr> +<p> +<strong>Note:</strong> If the moved track is connected but the track it is connect to is not moved, it will be disconnected, unless that track or the last selected track is a Cornu, in which case the Cornu concenred will be modified (if possible) to remain connected. +</p> +<p> +<strong>Note:</strong> Cornu tracks connected to a turntable will be modified if it is moved or rotated. They remain connected at the point on the radius where they started, so it may be desireable to delete and redraw them if the rotation is large. +</p> +<hr> +<ul> +<li><a href="moveByMouse.html#moveByMouse">2.2.9.1 Using Mouse</a></li> +<li><a href="moveByMenu.html#moveByMenu">2.2.9.2 Using Values of X and Y Translation</a></li> +</ul> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Using Mouse</title> +<link rel="previous" href="cmdMove.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="moveByMenu.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="moveByMouse"></a>2.2.9.1 Using Mouse</h1> +<p> +Once object(s) are selected, <em>Left+Drag</em> is used to move them around the layout using the mouse. +</p> +<p> +Alternatively, <em>Shift+Ctrl+Arrow</em> can be used to micro-move the selected object(s). The amount micro-moved is dependent on the zoom in use. To move by smaller increments, zoom in further. My moving to macro-zoom modes extremely fine adjustments can be made. +</p> +<p> +Remember that unattached objects can also be moved to exact positions using the <a href="cmdDescribe.html#cmdDescribe">Section 2.2.13</a> Command or by the <a href="moveByMenu.html#moveByMenu">Section 2.2.9.2</a>. +</p> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Using Values of X and Y Translation</title> +<link rel="previous" href="moveByMouse.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdMoveLabel.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="moveByMenu"></a>2.2.9.2 Using Values of X and Y Translation</h1> +<p> +Move An Object Using Fixed or Specified amounts of X and Y Translation. +</p> +<p> +A pop-up menu with additional menu items allows you to <strong>Move</strong> the selected object(s) through through any amount you specify. +</p> +<p> +<img src="png.d/mentermove.png"> +</p> +<p> +The <strong>Move</strong> command is executed as follows; +</p> +<ol><li> +<strong>Select</strong> the object(s) to be moved. +<p> + +</p> + +</li> +<li> +<em>Shift+Right-Click</em> to raise the Move/Rotate menu. +<p> + +</p> + +</li> +</ol> +<p> +Any amount of precise transalation may be entered by <em>Left-Click</em>ing the <strong>Enter Move...</strong> menu item then entering a desired amount of translation in X and Y in the dialog window that appears. +</p> +<p> + +</p> +<p> +<img src="png.d/dentermove.png"> +</p> +<p> + +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Move Description</title> +<link rel="previous" href="moveByMenu.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdPan.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdMoveLabel"></a>2.2.10 Move Description</h1> +<p> +<img src="png.d/bmovedes.png"> +</p> +<p> +This command is used to move Elevation, Grade, or Station (<a href="cmdElevation.html#cmdElevation">Section 2.2.5</a>), and to enable/disable and move Straight Track (<a href="cmdStraight.html#cmdStraight">Section 2.1.6</a>), Curved Track (<a href="cmdCurve.html#cmdCurve">Section 2.1.2</a>), Bezier (<a href="cmdBezier.html#cmdBezier">Section 2.1.2.5</a>, Cornu (<a href="cmdCornu.html#cmdCornu">Section 2.1.2.6</a>), Joint (<a href="cmdJoin.html#cmdJoin">Section 2.2.7</a>), Helix (<a href="cmdHelix.html#cmdHelix">Section 2.1.4</a>) and Structure or Turnout (<a href="cmdHotBar.html#cmdHotBar">Section 2.7</a>) Labels. +</p> +<p> +The <strong>Move Description</strong> command can be invoked using the <strong>Change>Move Description</strong> menu item or the <strong>Move Description</strong> button. +</p> +<p> +Click the <strong>Move Description</strong> button to activate the <strong>Move Description</strong> command. As the cursor passes close to an object that can display a label it will be highlighted. A dark blue indicates a label that has "Show Description" set on, a teal color means it is set to hide. +</p> +<p> +Use <em>Left+Drag</em> to move the label to a new position and unhide if hidden. Once moved, the label becomes fixed in a position relative to the object. Subsequent moves of that object will cause the label to move as well. +</p> +<p> +This operation can also be invoked by <em>Ctrl+Left+Drag</em> when in Select command (<a href="cmdSelect.html#cmdSelect">Section 2.2.16</a>). +</p> +<p> +Note that labels need to be visible in the Display menu and the layout needs to be zoomed in enough to show labels for them to be moved. +</p> +<p> +There are keys that control the display of description when hovering over a description or a track. +</p> +<ul><li> +The letter "<strong>s</strong>" when hovering over a track will show the hidden description - the teal highlight will show which tracks can have descriptions. +</li> +<li> +The letter "<strong>h</strong>", when hovering over the track or description, can be used to hide display of individual Curved Track, Bezier Track, Cornu, Helix, Joint or Turnout Labels. +</li> +<li> +The letter "<strong>d</strong>" will enable and disable a detailed description which is intended for tracklaying - it is a table of points and track angles that lie along the track path. +</li> +</ul> +<p> +Using these detailed values a curve can be constructed even for complex objects such as Bezier or Cornu. +</p> +<p> +There is a <strong>Context Menu</strong> invoked with <em>Right-Click</em> or <em>Shift plus Right-Click</em> to Show/Hide individual descriptions as well as set the description to detailed. +</p> +<p> +Labels can be moved by hovering the "hot spots" or over the attached track object. <em>Left-Drag</em> will reposition it. Elevation labels can be selected by hovering of thier centers or the end point they refer to. Note that end points with elevation mode "None" are not selectable. +</p> +<ul><li> +Cornu, Bezier, Straight, Curve and Joint (Easement) Labels can be moved along the line between the end-points and also laterally. +<p> + +</p> +<ul><li> +Cornu and Bezier Tracks show the "chord" length, its absolute angle, and the length of the track and the minimum radius. To help lay these variable radius curves out, the detailed description information about track centers and angles selected by <strong>'d'</strong> is suggested. +</li> +<li> +Joint/Easement Tracks show the "chord" length and abslute angle and easement curve constructing values of Radius and Lengths. For laying out larger easmements, the detailed position and angle description selected by <strong>'d'</strong> may be useful. +</li> +<li> +Straight Tracks show the length and the absolute angle. For laying out long straights, the detailed track center position and angle descriptions selected by <strong>'d'</strong> may be useful. +</li> +<li> +Curved Tracks show the radius, chord length, deflection at the center from the chord and the angular length. For laying out curves, the detailed track center position and angle descriptions selected by <strong>'d'</strong> may be useful. +</li> +</ul> + +</li> +</ul> +<p> + +</p> +<ul><li> +Curve Track Labels can be moved so that the label is somewhere on a radial line from the center to a position within the arc. A Curve label shows the absolute angle of the chord, its length, the Curve Radius and the deflection from the chord at the center of it. This enables the curve to be laid out even if the center point of the arc is inaccesible. Note that the detailed description may also be helpful in this case. +</li> +</ul> +<p> + +</p> +<ul><li> +Compound (Structure and Turnout) Labels can be moved without restriction. They show the Object's Title information. +</li> +</ul> +<p> + +</p> +<ul><li> +Elevation points labels can be moved without restriction - they show the Grade, Elevation, or Station Name as appropriate. +</li> +</ul> +<p> + +</p> +<ul><li> +The detailed description setting is not preserved in the saved layout. It is designed for use when transferring a complex part of the plan to a real layout. +</li> +</ul> +<p> +Note - existing defined elevation labels can be moved, but controlling thier visbility is done with the <a href="cmdElevation.html#cmdElevation">Section 2.2.5</a> command. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Pan/Zoom</title> +<link rel="previous" href="cmdMoveLabel.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdProfile.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdPan"></a>2.2.11 Pan/Zoom</h1> +<p> +<img src="png.d/pan.png"> +</p> +<p> +This command is used to move or resize the viewport using the mouse or keyboard. <em>Left+Drag</em> Pans the viewport up and down, left and right keping it within the boundaries of the layout. <em>Ctrl+Left-Drag</em> selects an area of the screen to zoom into. The <strong>"0"</strong> or <strong>"o"</strong> - key resets the display to the origin but leaves the zoom as is. Keys between <strong>1</strong> and <strong>9</strong> set the zoom to that zoom level. The <strong>"e"</strong> - key resets the origin to zero and the zooms to show the whole layout. +</p> +<p> +There is a context menu that contains these text based items as well. +</p> +<dl><dd> +<a name="i0"></a><em>Zoom/Pan Shortcut Keys</em> +<p> + +</p> +<ul><li> +Keys '1'-'9' set the zoom to between 1::1 and 1::9. +</li> +</ul> +<p> + +</p> +<ul><li> +Key 'e' sets the zoom to a value that allows all the room to be shown and moves the origin of the bottomm left of the window to 0,0 +</li> +</ul> +<p> + +</p> +<ul><li> +Key '0' or 'o' keeps the zoom as is, but moves the origin of the bottom left of the window to 0,0 +</li> +</ul> +<p> + +</p> +<ul><li> +Key 'c' moves the center of the window to the cursor position but leaves the zoom alone +</li> +</ul> + +</dd> +</dl> +<p> +As the window is Zoomed in and out, the setting of <strong>Constrain Drawing Area to Room Boundaries</strong> setting in the <strong>Display</strong> <a href="cmdDisplay.html#cmdDisplay">Section 2.10.3</a> dialog determines where the zoom is about. If it is not set, the center of the Drawing Area will stay fixed as the zoom changes. Otherwise, position of the Drawing Area will be constraned so any <strong>grey</strong> area will be to the right or above the room boundaries. +</p> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Profile</title> +<link rel="previous" href="cmdPan.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdDescribe.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdProfile"></a>2.2.12 Profile</h1> +<p> +The <strong>Profile</strong> dialog draws a profile showing elevations, distances and grades for a path on the layout. +</p> +<p> +<img src="png.d/dcprofile.png"> +</p> +<p> +Choose a path by using <em>Left-Click</em> on endpoints. As each endpoint is chosen, the path is extended via the shortest route. Selecting the end of the path trims the path back to a last <strong>Defined Elevation</strong> point (if any, otherwise the path is cleared). +</p> +<p> +If no route is possible an error message is displayed. There are several reasons why this might happen: +</p> +<ul><li> +The tracks are not connected. You can see this more easily if you turn on Display->Option->"Display Unconnected End Points" as Exception. You can also check this by using <em>Shift+Left-Click</em> on one track using the <strong>Select</strong> command (<a href="cmdSelect.html#cmdSelect">Section 2.2.16</a>). This selects all tracks connected (directly or indirectly). See if the other track is selected. +</li> +</ul> +<p> + +</p> +<ul><li> +One of the endpoints on the route is <strong>Ignored</strong> (<a href="cmdElevation.html#cmdElevation">Section 2.2.5</a>). Look for blue dots on the expected path when using the Profile or <strong>Elevation</strong> (<a href="cmdElevation.html#cmdElevation">Section 2.2.5</a>) commands. +</li> +</ul> +<p> + +</p> +<ul><li> +The only route connects to a section of track that is already on the path and is not the end of the path. Remove the end of the path until the connected track is not on the path. +</li> +</ul> +<p> +The path is drawn in the Profile Color (<a href="cmdRgbcolor.html#cmdRgbcolor">Section 2.10.1</a>) (default Purple) on the layout. +</p> +<p> +If the shortest path is not what you want, you can choose endpoints that are closer to the end of the path. Also, you can <strong>Ignore</strong> (<a href="cmdElevation.html#cmdElevation">Section 2.2.5</a>) endpoints to prevent the path from choosing a route through that endpoint. Shift+Right-Click (<a href="cmdAcclKeys.html#cmdAcclKeys">Section 3.4</a>) displays a pop-up menu that allows you to change the specified endpoint to be a <strong>Defined</strong>, <strong>Ignored</strong> or <strong>None</strong> Elevation endpoint. +</p> +<p> +Each <strong>Defined Elevation</strong> endpoint on the path is drawn as a Vertical bar, labeled with its height and distance from the beginning of the path. +</p> +<p> +The <strong>Grade</strong> between points is displayed between the vertical bars. The <strong>Grade</strong> line is drawn in Blue if that portion of the path does not contain more than one Shortest Path between Defined Elevation endpoints. Otherwise it is drawn in Red, to indicate the grade is an average and the actual grade may vary for any particular track segment. See Computing Dynamic Elevation (<a href="computeElevations.html#computeElevations">Section 2.2.5.1</a>) for more details. +</p> +<p> +<strong>Stations</strong> on the path are displayed along the bottom of the <strong>Profile</strong>. +</p> +<p> +The heights of <strong>Defined Elevations</strong> can be changed by using <em>Left+Drag</em> on the profile window. As you <strong>Drag</strong>, the new elevation and grades to each side are displayed at the bottom of the profile dialog. +</p> +<p> +The <strong>Change</strong> button makes the changes in the Profile dialog permanent. +</p> +<p> +The <strong>Reset</strong> button deletes all changes since the last press of <strong>Change</strong> or the start of the dialog. +</p> +<p> +The <strong>Clear</strong> button preserves elevation settings established along the current profile path, removes all profile points and leaves the <strong>Profile</strong> dialog open for selection of the next set of profile points. This function is useful when there's a need to view elevations along multiple profile paths. +</p> +<p> +The <strong>Print</strong> button prints the dialog. The aspect ratio is preserved on the print-out. You will probably want to print in landscape format. +</p> +<p> +The dialog can be closed with the 'X' button in the window's titlebar. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Properties</title> +<link rel="previous" href="cmdProfile.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="drawDescribe.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdDescribe"></a>2.2.13 Properties</h1> +<p> +<img src="png.d/bdescrib.png"> +</p> +<p> +Clicking on the <strong>Properties</strong> (Describe Mode) button cancels all active commands, closes any open dialog windows and places focus on the main window. +</p> +<p> +Until an object is selected, the object under the cursor that will be selected with <em>Left-Click</em> is highlighted in blue. Objects in Frozen Layers will only be highlighted and selected if <strong>Shift</strong> is added. +</p> +<p> +A <em>Left-Click</em> on an object while in <strong>Properties</strong> mode causes a properties dialog window to appear. The properties dialog contains information pertaining to the selected objects size, position, size, color and layer as appropriate for each type of object. Certain values can be changed to modify the object. Some values, e.g., endpoint positions, can not be changed if, for example, a Track is joined to another Track. The values will take effect when <strong>Enter</strong>, <strong>Tab</strong> is pressed or the cursor leaves the entry field. +</p> +<p> +<img src="png.d/dproperties.png"> +</p> +<p> +The selected object is highlighted by a grey area. +</p> +<p> +<img src="png.d/dpropertieshighlight.png"> +</p> +<ul> +<li><a href="drawDescribe.html#drawDescribe">2.2.13.1 Draw Object Describe Fields</a></li> +<ul> +<li><a href="drawDescribeCommon.html#drawDescribeCommon">2.2.13.1.1 Common Draw Object Fields</a></li> +<li><a href="drawDescribeStr.html#drawDescribeStr">2.2.13.1.2 Straight Line Objects Describe Fields</a></li> +<li><a href="drawDescribeDim.html#drawDescribeDim">2.2.13.1.3 Dimension Line Objects</a></li> +<li><a href="drawDescribeBench.html#drawDescribeBench">2.2.13.1.4 BenchWork Objects Describe Fields</a></li> +<li><a href="drawDescribeCurve.html#drawDescribeCurve">2.2.13.1.5 Curved and Circle Objects Describe Fields</a></li> +<li><a href="drawDescribePoly.html#drawDescribePoly">2.2.13.1.6 Polygon Objects Describe Fields</a></li> +<li><a href="drawDescribeText.html#drawDescribeText">2.2.13.1.7 Text Objects Describe Fields</a></li> +</ul> +<li><a href="DescribeCompound.html#DescribeCompound">2.2.13.2 Structures, Sectional Track and Turnouts Describe Fields</a></li> +<li><a href="DescribeTrack.html#DescribeTrack">2.2.13.3 Describe Track Fields</a></li> +<ul> +<li><a href="trackDescribeCommon.html#trackDescribeCommon">2.2.13.3.1 Common Track Object Fields</a></li> +<li><a href="trackDescribeStr.html#trackDescribeStr">2.2.13.3.2 Straight Track Describe Fields</a></li> +<li><a href="trackDescribeCurve.html#trackDescribeCurve">2.2.13.3.3 Curved Track Describe Fields</a></li> +<li><a href="trackDescribeCornu.html#trackDescribeCornu">2.2.13.3.4 Cornu Track Describe Fields</a></li> +<li><a href="trackDescribeBezier.html#trackDescribeBezier">2.2.13.3.5 Bezier Track Describe Fields</a></li> +</ul> +</ul> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Draw Object Describe Fields</title> +<link rel="previous" href="cmdDescribe.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="drawDescribeCommon.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="drawDescribe"></a>2.2.13.1 Draw Object Describe Fields</h1> +<ul> +<li><a href="drawDescribeCommon.html#drawDescribeCommon">2.2.13.1.1 Common Draw Object Fields</a></li> +<li><a href="drawDescribeStr.html#drawDescribeStr">2.2.13.1.2 Straight Line Objects Describe Fields</a></li> +<li><a href="drawDescribeDim.html#drawDescribeDim">2.2.13.1.3 Dimension Line Objects</a></li> +<li><a href="drawDescribeBench.html#drawDescribeBench">2.2.13.1.4 BenchWork Objects Describe Fields</a></li> +<li><a href="drawDescribeCurve.html#drawDescribeCurve">2.2.13.1.5 Curved and Circle Objects Describe Fields</a></li> +<li><a href="drawDescribePoly.html#drawDescribePoly">2.2.13.1.6 Polygon Objects Describe Fields</a></li> +<li><a href="drawDescribeText.html#drawDescribeText">2.2.13.1.7 Text Objects Describe Fields</a></li> +</ul> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Common Draw Object Fields</title> +<link rel="previous" href="drawDescribe.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="drawDescribeStr.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="drawDescribeCommon"></a>2.2.13.1.1 Common Draw Object Fields</h1> +<p> +If the Object is a Line, Curve, Circle or Polygon object, and the rotation origin is non-zero, a large blue cross will show its position. If it is zero, the command starts with the <strong>Lock Origin</strong> field unticked and the <strong>Rotate By</strong> field greyed out. +</p> +<p> +Some fields are used by multiple types of objects - these are listed below +</p> +<dl><dt> +Line Width +</dt> +<dd> +The width of the line for a line, curve or unfilled object can be set. 0 means a pixel width at all scales. Other values are the width of the line in scale units. If the value is negative, it is the absolute value of pixels wide at all scales. +</dd> +<dt> +Pivot +</dt> +<dd> +The Pivot control can be set to fix in place the start, or the middle or the end, and it applies to the Length, Line Angle and Angular Length controls. When these are changed the new dimensions are applied so as to keep the locked position in place. +</dd> +<dt> +Rotation Origin +</dt> +<dd> +By default the rotation origin is the Layout origin {0,0}. If the origin is not at the Layout origin, it will be displayed with a blue cross. When the origin is changed with the <strong>Lock</strong> off, the object is not moved. But if the origin is changed with the <strong>Lock</strong> on, the object will be moved as well. Enabling the <strong>Lock To Origin</strong> allows subsequent Rotations to be about the origin. This may be especially useful when using creating larger groups of Draw objects. +</dd> +<dt> +Lock To Origin +</dt> +<dd> +Locking to the rotation origin makes the distance between the First Point and the origin fixed. If this is set on, altering either the First Point or the Rotation Origin will move the both values. This value is initially set to locked if the Draw origin is non-zero when the <a href="cmdDescribe.html#cmdDescribe">Section 2.2.13</a> command is started but can be unset to allow repositioning of the Rotate Origin without moving the object in the layout. If the Rotate Origin is set to {0,0}, the Object has an <em>Absolute</em> origin. +</dd> +<dt> +Rotate By +</dt> +<dd> +Some Draw objects (Polygon, Polyline, Lines, Curves, Circles, Text) can be rotated about their rotation origin in Describe. In order to rotate them, the <strong>Lock To Origin</strong> must be enabled. After the rotation completes, the rotation angle will be set back to zero and all the points of the object will be adjusted to their absolute position in the layout. Negative values of rotation are counter-clockwise. Note that for Text objects, the Rotation also changes the <strong>Text Angle</strong>. +</dd> +<dt> +Layer +</dt> +<dd> +The layer of the object. The object can be moved between layers if the layer is not frozen. Only non-frozen layers are listed as options. +</dd> +<dt> +Color +</dt> +<dd> +The color of the line or the fill can be set +</dd> +</dl> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Straight Line Objects Describe Fields</title> +<link rel="previous" href="drawDescribeCommon.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="drawDescribeDim.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="drawDescribeStr"></a>2.2.13.1.2 Straight Line Objects Describe Fields</h1> +<dl><dt> +End Pt 1 +</dt> +<dd> +For Straight Lines the object has a starting position (or first point) - altering this value causes the whole object to move relative to the layout origin. +</dd> +<dt> +End Pt 2 +</dt> +<dd> +Straight Lines have a second point, altering this, moves just that end of the line, altering its length as needed. +</dd> +<dt> +Line Angle +</dt> +<dd> +Straight Lines have an angle - this is the angle between the two points, altering this moves the ends so as to respect the <strong>Pivot</strong> control setting. +</dd> +<dt> +Length +</dt> +<dd> +The Length control can add to the start or end or both of a Line object depending on the setting of the <strong>Pivot</strong> control setting. +</dd> +</dl> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Dimension Line Objects</title> +<link rel="previous" href="drawDescribeStr.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="drawDescribeBench.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="drawDescribeDim"></a>2.2.13.1.3 Dimension Line Objects</h1> +<dl><dt> +Size +</dt> +<dd> +The size of the arrows and text can be set to Tine, Small, Medium or Large. +</dd> +</dl> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>BenchWork Objects Describe Fields</title> +<link rel="previous" href="drawDescribeDim.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="drawDescribeCurve.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="drawDescribeBench"></a>2.2.13.1.4 BenchWork Objects Describe Fields</h1> +<dl><dt> +Lumber +</dt> +<dd> +A set of standard dimensions of timber sizes that are often used to construct benchwork. They are specified in "nominal" dimensions but drawn in "actual" dimensions. +</dd> +<dt> +Orientation +</dt> +<dd> +The timber can be orientated "On Edge" which will draw the smaller dimension or "Flat". +</dd> +</dl> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Curved and Circle Objects Describe Fields</title> +<link rel="previous" href="drawDescribeBench.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="drawDescribePoly.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="drawDescribeCurve"></a>2.2.13.1.5 Curved and Circle Objects Describe Fields</h1> +<dl><dt> +Center +</dt> +<dd> +Curved Lines and Circles have a center. Moving this moves the object. +</dd> +<dt> +CW Angle and CCW Angle +</dt> +<dd> +Curved Lines have an angle relative to the center that the arc starts and and one where it ends. +</dd> +<dt> +Angular Length +</dt> +<dd> +For Curved Lines this is the length of the arc in degrees. If altered it will move the arc to respect the <strong>Pivot</strong> control setting. +</dd> +</dl> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Polygon Objects Describe Fields</title> +<link rel="previous" href="drawDescribeCurve.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="drawDescribeText.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="drawDescribePoly"></a>2.2.13.1.6 Polygon Objects Describe Fields</h1> +<dl><dt> +Fill +</dt> +<dd> +Some draw objects (Circles, Polygons) can be filled or emptied - note that Polylines can not be filled - they have to be closed first. +</dd> +<dt> +Open +</dt> +<dd> +Unfilled Polygons can be opened to become Polylines or Polylines closed to become Polygons. Note that PolyLines can't be filled, they have to be closed first. +</dd> +<dt> +Point Count +</dt> +<dd> +Polygons and PolyLines have a count of nodes - this is read-only. +</dd> +<dt> +Height and Width +</dt> +<dd> +Rectangular Polygons have two properties that can alter the Height and Width of the Polygon +</dd> +<dt> +Line Type +</dt> +<dd> +Straight and Curved Lines, PolyLines, Polygons and Structures can be drawn with dotted, dashed, dash-dotted and dash-dot-dotted lines. +</dd> +</dl> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Text Objects Describe Fields</title> +<link rel="previous" href="drawDescribePoly.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="DescribeCompound.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="drawDescribeText"></a>2.2.13.1.7 Text Objects Describe Fields</h1> +<dl><dt> +Text Angle +</dt> +<dd> +For Text objects, the Text Angle determines the absolute angle the text is rendered at. +</dd> +</dl> +<p> +This will be set by itself or by rotation of the starting position about the Rotation Origin with <strong>Lock to Origin</strong> set. +</p> +<dl><dt> +Boxed +</dt> +<dd> +For Text objects, whether a line is drawn around the text. +</dd> +</dl> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Structures, Sectional Track and Turnouts Describe Fields</title> +<link rel="previous" href="drawDescribeText.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="DescribeTrack.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="DescribeCompound"></a>2.2.13.2 Structures, Sectional Track and Turnouts Describe Fields</h1> +<dl><dt> +Pivot +</dt> +<dd> +The Pivot fixes the point about which the Angle of Rotation will occur to be the Start (Bottom Left) Point, the middle of the object, or End (Top Right) of the object. These relative positions are calculated as though the object was rotated by zero degrees. +</dd> +<dt> +Angle +</dt> +<dd> +The Angle rotates the object about the Pivot point. +</dd> +</dl> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Describe Track Fields</title> +<link rel="previous" href="DescribeCompound.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="trackDescribeCommon.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="DescribeTrack"></a>2.2.13.3 Describe Track Fields</h1> +<ul> +<li><a href="trackDescribeCommon.html#trackDescribeCommon">2.2.13.3.1 Common Track Object Fields</a></li> +<li><a href="trackDescribeStr.html#trackDescribeStr">2.2.13.3.2 Straight Track Describe Fields</a></li> +<li><a href="trackDescribeCurve.html#trackDescribeCurve">2.2.13.3.3 Curved Track Describe Fields</a></li> +<li><a href="trackDescribeCornu.html#trackDescribeCornu">2.2.13.3.4 Cornu Track Describe Fields</a></li> +<li><a href="trackDescribeBezier.html#trackDescribeBezier">2.2.13.3.5 Bezier Track Describe Fields</a></li> +</ul> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Common Track Object Fields</title> +<link rel="previous" href="DescribeTrack.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="trackDescribeStr.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="trackDescribeCommon"></a>2.2.13.3.1 Common Track Object Fields</h1> +<dl><dt> +End Pt 1 +</dt> +<dd> +For the starting position (or first point) - altering this value causes the whole object to move relative to the layout origin. This can only be changed if the track is unconnected at that end. The elevation is shown beneath the X,Y as a read-only Z value. +</dd> +<dt> +End Pt 2 +</dt> +<dd> +The end position (or second point), altering this, moves just that end of the line, altering its length as needed. This can only be changed if the track is unconnected at that end. The elevation is shown beneath the X,Y as a read-only Z value. +</dd> +<dt> +Grade +</dt> +<dd> +The calculated grade between the two end-points +</dd> +<dt> +Layer +</dt> +<dd> +The layer of the object. The object can be moved between layers if the layer is not frozen. Only non-frozen layers are listed as options. +</dd> +<dt> +Length +</dt> +<dd> +The length of the track object. This can be set for a Straight Track if it is not connected, and will respect the value of the <strong>Pivot</strong> field. +</dd> +<dt> +Pivot +</dt> +<dd> +The Pivot control can be set to fix in place the start, or the middle or the end, and it applies to the Length, Track Angle and Angular Length controls. When these are changed the new dimensions are applied so as to keep the locked position in place. +</dd> +</dl> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Straight Track Describe Fields</title> +<link rel="previous" href="trackDescribeCommon.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="trackDescribeCurve.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="trackDescribeStr"></a>2.2.13.3.2 Straight Track Describe Fields</h1> +<dl><dt> +Track Angle +</dt> +<dd> +The angle of the Track object. This can be set if the track is not connected. It respects the value of the <strong>Pivot</strong> field +</dd> +</dl> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Curved Track Describe Fields</title> +<link rel="previous" href="trackDescribeStr.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="trackDescribeCornu.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="trackDescribeCurve"></a>2.2.13.3.3 Curved Track Describe Fields</h1> +<dl><dt> +Center +</dt> +<dd> +The center point of the curve. The center can only be modified if both ends are unconnected. +</dd> +<dt> +Radius +</dt> +<dd> +The radius of the curve. The radius can only be modified if one end is not connected. +</dd> +<dt> +Angular Length +</dt> +<dd> +The length of the curve in degrees. Modifications respect the <strong>Pivot</strong> value and are only available if at least one end is disconnected. +</dd> +<dt> +CCW Angle +</dt> +<dd> +The Counter-Clockwise Angle (the angle from the center to the first position). Can only be modified if the first end of the curve is not connected. +</dd> +<dt> +CW Angle +</dt> +<dd> +The ClockWise Angle (the angle from the center to the end position). Can only be modified if the second end of the curve is not connected. +</dd> +</dl> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Cornu Track Describe Fields</title> +<link rel="previous" href="trackDescribeCurve.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="trackDescribeBezier.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="trackDescribeCornu"></a>2.2.13.3.4 Cornu Track Describe Fields</h1> +<dl><dt> +End Angle +</dt> +<dd> +Each end has an angle which helps determine the curve shape. It can only be set if the Track is not joined at that end. +</dd> +<dt> +End Radius +</dt> +<dd> +Each end has an radius which helps determine the curve shape. It can only be set if the Track is not joined at that end. +</dd> +<dt> +End Pt +</dt> +<dd> +Each End Point has a position. It can only be set if the Track is not joined at that end. +</dd> +<dt> +Center +</dt> +<dd> +Each End shows the center of the curve of the end segment - this is a read-only field. If the radius is zero, the field will show {0,0}. +</dd> +<dt> +Minimum Radius +</dt> +<dd> +This is the approximate smallest radius along the curve based on curve fitting to the Cornu. +</dd> +<dt> +Maximum Rate of Curvature +</dt> +<dd> +The maximum rate that the radius is changing over its length based on curve fitting. It gives an idea of the "sharpness" of the curve. +</dd> +<dt> +Total Winding Angle +</dt> +<dd> +The number of degrees that the curve executes - this number will rise if there are loops in the curve. +</dd> +</dl> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Bezier Track Describe Fields</title> +<link rel="previous" href="trackDescribeCornu.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdRaiseElev.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="trackDescribeBezier"></a>2.2.13.3.5 Bezier Track Describe Fields</h1> +<dl><dt> +Ctl Pt +</dt> +<dd> +The positions of the two Bezier control points. These will only be adjustable if the end they control is not attached to another track. +</dd> +<dt> +End Angle +</dt> +<dd> +Each end has an angle which is set by the control arm at that end - this is a read-only field +</dd> +<dt> +End Radius +</dt> +<dd> +Each end has an radius which is driven by the curve shape - this is a read-only field +</dd> +<dt> +End Pt +</dt> +<dd> +Each End Point has a position. It can only be set if the Track is not joined at that end. +</dd> +<dt> +Center +</dt> +<dd> +Each End shows the center of the curve of the end segment - this is a read-only field. If the radius is zero, the field will show {0,0}. +</dd> +<dt> +Minimum Radius +</dt> +<dd> +This is the approximate smallest radius along the curve based on curve fitting to the Bezier. +</dd> +</dl> +<hr> +<p> +Most commands return to <strong>Properties</strong> mode then they terminate unless the command is sticky (<a href="cmdSticky.html#cmdSticky">Section 2.10.8</a>). +</p> +<p> +Note: the Default Command radio button on the <strong>Command Options</strong> (<a href="cmdCmdopt.html#cmdCmdopt">Section 2.10.2</a>) dialog controls whether the <strong>Properties</strong> or the <strong>Select</strong> (<a href="cmdSelect.html#cmdSelect">Section 2.2.16</a>) command is used as the default command. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Raise or Lower Elevation</title> +<link rel="previous" href="trackDescribeBezier.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdRotate.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdRaiseElev"></a>2.2.14 Raise or Lower Elevation</h1> +<p> +This command allows you to raise or lower the elevation of all selected tracks. +</p> +<p> +<img src="png.d/dchgelev.png"> +</p> +<p> +The entered value is added to all Defined Elevations on the Selected tracks. A negative value will lower the Elevations. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Rotate</title> +<link rel="previous" href="cmdRaiseElev.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="rotateByMouse.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdRotate"></a>2.2.15 Rotate</h1> +<p> +<img src="png.d/brotate.png"> +</p> +<p> +This command is used to rotate selected (<a href="cmdSelect.html#cmdSelect">Section 2.2.16</a>) objects. +</p> +<p> +The <strong>Rotate</strong> command can be invoked using the <strong>Change>Rotate</strong> menu item, the <strong>Rotate</strong> button, the menu raised by a <em>Right-Click</em> over the <strong>Main Canvas</strong> or by the <em>Ctrl+Right-Drag</em> command when over a selected trak in <strong>Select</strong> mode. +</p> +<p> +Successful use of this command requires selection of the object(s) to be rotated before attempting to rotate it. An object is selected by using the <em>Left-Click</em> command. A group of connected objects can be selected using the <em>Shift+Left-Click</em> command, or indivdual tracks added with <em>Ctrl+Left-Click</em>. +</p> +<p> +A pop-up menu with commands controlling how objects move during the <strong>Rotate</strong> function can be activated by entering a <em>Shift+Right-Click</em> command while hovering over the <strong>Main Canvas</strong>. +</p> +<p> +Note that a Rotate command for a Draw object does not use the Rotation Origin of that Object, even if has been defined as non-zero, instead it uses the position defined by the mouse or context command, and does not rotate the rotation origin. +</p> +<p> +<img src="png.d/mrotatemove.png"> +</p> +<p> +Rotation can be achieved using one of the following methods; +</p> +<p> + +</p> +<dl><dd> +<em>Left+Drag</em> using the mouse. See <a href="rotateByMouse.html#rotateByMouse">Section 2.2.15.1</a> for detail. +</dd> +</dl> +<p> + +</p> +<dl><dd> +Selecting fixed or specified degrees of rotation using a <em>Right-Click</em> menu. See <a href="rotateByMenu.html#rotateByMenu">Section 2.2.15.2</a> for detail. +</dd> +</dl> +<p> + +</p> +<dl><dd> +Aligning the selected object with another object on the layout. See <a href="rotateByAlign.html#rotateByAlign">Section 2.2.15.3</a> for detail. +</dd> +</dl> +<p> +During Rotation of a track, if <strong>MagneticSnap</strong> (<a href="cmdMagneticSnap.html#cmdMagneticSnap">Section 2.12.1</a>) is enabled, if one of the end-points of the selected objects is close to an open end of a unselected point, two anchors (an open an closed blue ball) will appear. This indicates that the two points will auto-snap and the moved track will align to the unselected point if the Rotation is stopped. This does not happen if <em>Alt</em> is used. If <strong>MagneticSnap</strong> is disabled, the snap will only occur if <em>Alt</em> is held. Note that this also applies to <a href="cmdMove.html#cmdMove">Section 2.2.9</a>. +</p> +<hr> +<ul> +<li><a href="rotateByMouse.html#rotateByMouse">2.2.15.1 Using Mouse</a></li> +<li><a href="rotateByMenu.html#rotateByMenu">2.2.15.2 Using Degree's of Rotation</a></li> +<li><a href="rotateByAlign.html#rotateByAlign">2.2.15.3 Aligned With Another Object</a></li> +</ul> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Using Mouse</title> +<link rel="previous" href="cmdRotate.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="rotateByMenu.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="rotateByMouse"></a>2.2.15.1 Using Mouse</h1> +<p> +Rotate An Object Using the Mouse +</p> +<ol><li> +<strong>Select</strong> the object(s) to be rotated. +<p> + +</p> + +</li> +<li> +Click the <strong>Rotate</strong> button (<img src="png.d/brotate.png">) to activate the <strong>Rotate</strong> function. +<p> + +</p> + +</li> +<li> +Visualize an axis point on the object that's to be rotated then place the mouse pointer over that point. If the track is a turntable, the point will be snapped to the turntable center if the mouse is within a quarter of the radius length of it. +<p> + +</p> + +</li> +<li> +Click and hold the left mouse button then drag (<em>Left+Drag</em>) the mouse away from the axis point to create a "handle". This handle will be used to rotate the object. While continuing to hold the left mouse button, drag (<em>Left+Drag</em>) the handle in the desired direction of rotation. <strong>Note:</strong> If the <em>Shift+Ctrl</em> key is pressed in conjunction with <em>Left+Drag</em>, the object will rotate in increments of 15°. +<p> + +</p> + +</li> +<li> +Release the mouse key once desired rotation is obtained. +</li> +</ol> +<p> + +</p> +<ol><li> +If <strong>Magnetic Snap</strong> is enabled and the <em>Alt</em> button is not pressed, or ifthe <em>Alt</em> button is pressed when it is disabled, a magnetic anchor will be displayed if an end of the rotated tracks is near an open end. If the anchor shows and the rotate is completed, the tracks will Snap to Alignment and Join. +</li> +</ol> +<p> + +</p> +<p> +Rotation can also be achieved through use of one of these alternate methods; +</p> +<p> + +</p> +<dl><dd> +Selecting fixed or specified degrees of rotation using a <em>Right-Click</em> menu. See <a href="rotateByMenu.html#rotateByMenu">Section 2.2.15.2</a> for detail. +</dd> +</dl> +<p> + +</p> +<dl><dd> +Aligning the selected object with another object on the layout. See <a href="rotateByAlign.html#rotateByAlign">Section 2.2.15.3</a> for detail. +</dd> +</dl> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Using Degree's of Rotation</title> +<link rel="previous" href="rotateByMouse.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="rotateByAlign.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="rotateByMenu"></a>2.2.15.2 Using Degree's of Rotation</h1> +<p> +Rotate An Object Using Fixed or Specified Degree's of Rotation +</p> +<p> +A pop-up menu with additional menu items allows you to <strong>Rotate</strong> the selected object(s) through various predefined angles or through any angle you specify. +</p> +<p> +<img src="png.d/mrotatemove.png"> +</p> +<p> +The <strong>Rotate</strong> command is executed as follows; +</p> +<ol><li> +<strong>Select</strong> the object(s) to be rotated. +<p> + +</p> + +</li> +<li> +Click the <strong>Rotate</strong> button (<img src="png.d/brotate.png">) to activate the <strong>Rotate</strong> function. +<p> + +</p> + +</li> +<li> +With the mouse pointer hovering over the point about which the object(s) are to be rotated, <em>Shift+Right-Click</em> to raise the Rotate menu then select the desired degree and direction of rotation from the list of predefined angles (180°, 90° CW, 45° CW, 30° CW, 15° CW, 15° CCW, 30° CCW, 45° CCW, 90° CCW). +<p> + +</p> + +</li> +</ol> +<p> +<img src="png.d/mrotatefixed.png"> +</p> +<p> + +</p> +<hr> +<p> +Alternately, any angle may be entered by <em>Left-Click</em>ing the <strong>Enter Angle...</strong> menu item +</p> +<ol><li> +<strong>Select</strong> the object(s) to be rotated. +<p> + +</p> + +</li> +<li> +With the mouse pointer hovering over the point about which the object(s) are to be rotated, <em>Shift+Right-Click</em> to raise the Rotate menu and then select the <em>Enter Angle...</em> option. +<p> + +</p> + +</li> +</ol> +<p> +<img src="png.d/mrotatevariable.png"> +</p> +<p> +And then entering a desired angle in the Rotate dialog window that appears. +</p> +<p> +<img src="png.d/drotateangle.png"> +</p> +<p> + +</p> +<p> +Rotation can also be achieved through use of one of these alternate methods; +</p> +<p> + +</p> +<dl><dd> +<em>Left+Drag</em> using the mouse. See <a href="rotateByMouse.html#rotateByMouse">Section 2.2.15.1</a> for detail. +</dd> +</dl> +<p> + +</p> +<dl><dd> +Aligning the selected object with another object on the layout. See <a href="rotateByAlign.html#rotateByAlign">Section 2.2.15.3</a> for detail. +</dd> +</dl> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Aligned With Another Object</title> +<link rel="previous" href="rotateByMenu.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdSelect.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="rotateByAlign"></a>2.2.15.3 Aligned With Another Object</h1> +<p> +Rotate and Align An Object With Another Object +</p> +<p> +A pop-up menu with additional menu items allows you to <strong>Align</strong> the selected object(s) with any other object on the layout. The <strong>Align</strong> command is executed as follows; +</p> +<ol><li> +<strong>Select</strong> the object(s) to be rotated. +<p> + +</p> + +</li> +<li> +Click the <strong>Rotate</strong> button (<img src="png.d/brotate.png">) to activate the <strong>Rotate</strong> function. +<p> + +</p> + +</li> +<li> +With the mouse pointer hovering over the point about which the object(s) are to be rotated, <em>Shift+Right-Click</em> to raise the Rotate menu then select <strong>Align</strong>. +<p> + +</p> +<p> +<img src="png.d/mrotatealign.png"> +</p> +<p> + +</p> + +</li> +<li> +<em>Left-Click</em> on the (selected) object that is to be rotated. +<p> + +</p> + +</li> +<li> +<em>Left-Click</em> on the object with which you want the selected object aligned. The selected object will rotate to align with the reference object. +</li> +</ol> +<p> + +</p> +<p> +Rotation can also be achieved through use of one of these alternate methods; +</p> +<p> + +</p> +<dl><dd> +<em>Left+Drag</em> using the mouse. See <a href="rotateByMouse.html#rotateByMouse">Section 2.2.15.1</a> for detail. +</dd> +</dl> +<p> + +</p> +<dl><dd> +Selecting fixed or specified degrees of rotation using a <em>Right-Click</em> menu. See <a href="rotateByMenu.html#rotateByMenu">Section 2.2.15.2</a> for detail. +</dd> +</dl> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Select</title> +<link rel="previous" href="rotateByAlign.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdSplit.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdSelect"></a>2.2.16 Select</h1> +<p> +<img src="png.d/bselect.png"> +</p> +<p> +Clicking on the <strong>Select</strong> button cancels all active commands, closes any open dialog windows and places focus on the main window. +</p> +<p> +In combination with the mouse, the <strong>Select</strong> command can be used as follows; +</p> +<dl><dd> +Unselected Objects that will be added to the selected set with a <em>Left-Click</em> are highlighted in Blue as the mouse moves over them. Items that will be deselected are highlighted in Gold. +</dd> +</dl> +<p> + +</p> +<dl><dd> +Objects that are part of a <strong>Module Layer</strong> are selected or deselected together. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<em>Left-Click</em> - if the <strong>SelectMode</strong> in <a href="cmdCmdopt.html#cmdCmdopt">Section 2.10.2</a> is set to Single Item Mode it selects just an object near the cursor. If it is set to Add Item Mode, it will add the nearby object or remove it if is already selected. Already selected objects appear in red (unless changed in the <strong>Color</strong> (<a href="cmdRgbcolor.html#cmdRgbcolor">Section 2.10.1</a>) dialog) and a blue selection box surrounds all currently selected objects. If <strong>SelectZero</strong> is selected in <a href="cmdCmdopt.html#cmdCmdopt">Section 2.10.2</a> and an point that is not near to any object is selected, all objects are deselected. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<em>Ctrl+Left-Click</em> - if <strong>SelectMode</strong> in <a href="cmdCmdopt.html#cmdCmdopt">Section 2.10.2</a> is set to Single Item Mode it adds an object near to the cursor to the selected objects, or removes if it is already selected. If set to Add Item Mode, it will select only the nearby object and delselect all the others. Already selected objects appear in red (unless changed in the <strong>Color</strong> (<a href="cmdRgbcolor.html#cmdRgbcolor">Section 2.10.1</a>) dialog) and a blue selection box surrounds all currently selected objects. If <strong>SelectZero</strong> is selected in <a href="cmdCmdopt.html#cmdCmdopt">Section 2.10.2</a> and an point that is not near to any objects is selected, all objects are deselected. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<em>Shift+Left-Click</em> - selects all unselected tracks connected to a track you select. Selection stops at already selected tracks. Caution: This can select all tracks on the layout. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<em>Left+Drag</em> - highlights an area, and all the objects within the area are selected, if <strong>SelectMode</strong> is in <a href="cmdCmdopt.html#cmdCmdopt">Section 2.10.2</a> is set to "Add", already selected objects outside the area remain selected, otherwise "Only", they are deselected. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<em>Right-Drag</em> - highlights an area, and all the objects within the area are unselected regardless of <strong>SelectMode</strong>. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<em>Right-Click</em> and <em>Shift-Right-Click</em> - either display a pop-up menu of commands or a set of context commands for the item under the cursor depending on the setting of "Right-Click" in <a href="cmdCmdopt.html#cmdCmdopt">Section 2.10.2</a>. +<p> + +</p> +<p> +<img src="png.d/mselectcmd.png"> or <img src="png.d/mselectcontext.png"> +</p> +<p> + +</p> + +</dd> +</dl> +<p> + +</p> +<dl><dd> +<em>Double-Click</em> - invokes <a href="cmdModify.html#cmdModify">Section 2.2.8</a> on the object after selecting it for eligible objects. Otherwise it acts as <em>Left-Click</em>. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<em>"?"</em> - displays the Property menu for the object hovered over +</dd> +</dl> +<p> + +</p> +<ul><li> +<em>"e"</em> sets the zoom to a value that allows all the room to be shown and moves the origin of bottom left of the window to be 0,0 +</li> +</ul> +<p> + +</p> +<ul><li> +<em>"s"</em> sets the zoom to show the selected set of objects and pans the window to center the highlit area. +</li> +</ul> +<p> + +</p> +<dl><dd> +<em>"c"</em> - moves the center of the window (i.e., Pans) to be at the cursor position +</dd> +</dl> +<p> + +</p> +<dl><dd> +Hovering over a selected object (inside the blue highlight area) displays an anchor. The Anchor shows the actions available - +<ul><li> +If the <em>Shift</em> key is depressed, a "cross-arrows" anchor shows that a <a href="cmdMove.html#cmdMove">Section 2.2.9</a> will occur with <em>Left-Click</em>. +</li> +<li> +If the <em>Ctrl</em> key is depresesed, a "rotation-circle" anchor shows that a <a href="cmdRotate.html#cmdRotate">Section 2.2.15</a> will occur with <em>Left-Click</em>. +</li> +<li> +With neither depressed a "target" anchor shows that a <em>Double-Click</em> will invoke <a href="cmdModify.html#cmdModify">Section 2.2.8</a> within Select for the object hovered over. +</li> +</ul> + +</dd> +</dl> +<p> + +</p> +<dl><dd> +<em>Shift+Ctrl</em> plus the <em>Arrow Keys</em> will move the selected items a pixel at a time at the current zoom level. No autosnap will occur to permit fine tuning. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<em>Shift+Right-Click</em> or <em>Right-Click</em> (depending on the setting of <strong>Right-Click</strong> in <a href="cmdCmdopt.html#cmdCmdopt">Section 2.10.2</a>) - Shows context menu items that allow you to perform actions on the selected item(s) including rotating them by various angles and moving them fixed amounts. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<em>Shift+Left-Click+Drag</em> - on a selected object moves the selected objects (the Move (<a href="cmdMove.html#cmdMove">Section 2.2.9</a>) command). +</dd> +</dl> +<p> + +</p> +<dl><dd> +<em>Ctrl+Left-Click+Drag</em> - on a selected object rotates the selected objects (the <strong>Rotate</strong> (<a href="cmdRotate.html#cmdRotate">Section 2.2.15</a>) command). +<ul><li> +If the <em>Shift</em> key is pressed while dragging in rotation then rotation will occur in 15° increments. +</li> +<li> +If the selected items(s) are moved or rotated using the cursor, and an open end of unselected tracks is close to an end of the selected tracks that will be open after the move, a pair ot anchors shows that an autosnap with alignment will occur. Upon release of the button, all the selected tracks will be moved and aligned and the tracks joined. +</li> +</ul> + +</dd> +</dl> +<p> + +</p> +<dl><dd> +<em>Double-Click</em> - on a eligible object such as a Link Object will Activate it, and on a Modifyable object will go into Modify Mode (<a href="cmdModify.html#cmdModify">Section 2.2.8</a>) within Select. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<em>Right-Click</em> and <em>Shift-Right-Click</em> - either display a pop-up menu of commands or a set of context commands for the items selected depending on the setting of "Right-Click" in <a href="cmdCmdopt.html#cmdCmdopt">Section 2.10.2</a>. The options effects depend on the type of object(s) selected and hovered over. +<p> + +</p> +<p> +<img src="png.d/mselectcmd.png"> or <img src="png.d/mselectedcontext.png"> +</p> +<p> + +</p> + +</dd> +</dl> +<p> +Once Objects are +</p> +<p> +Once objects are selected, the following commands operate on them: +</p> +<ul><li> +<strong>Move</strong> (<a href="cmdMove.html#cmdMove">Section 2.2.9</a>) the selected objects. +</li> +<li> +<strong>Rotate</strong> (<a href="cmdRotate.html#cmdRotate">Section 2.2.15</a>) the selected objects. +</li> +<li> +<strong>Flip</strong> (<a href="cmdFlip.html#cmdFlip">Section 2.2.6</a>) (mirrors) the selected objects. +</li> +<li> +<strong>Delete</strong> (<a href="cmdDelete.html#cmdDelete">Section 2.4.4</a>) selected objects. +</li> +<li> +<strong>Hide</strong> (or unhide) in a Tunnel (<a href="cmdTunnel.html#cmdTunnel">Section 2.4.5</a>). +</li> +<li> +<strong>Move</strong> Above or Below (<a href="cmdAboveBelow.html#cmdAboveBelow">Section 2.4.2</a>). +</li> +<li> +<strong>Parts List</strong> (<a href="cmdEnum.html#cmdEnum">Section 2.9.6</a>) of the selected objects. +</li> +<li> +<strong>Change</strong> the width of the tracks' rails. +</li> +<li> +<strong>Export</strong> (<a href="cmdExport.html#cmdExport">Section 2.5.1</a>) the selected objects. +</li> +<li> +<strong>Group</strong> Creates a structure or turnout definition (<a href="cmdGroup.html#cmdGroup">Section 2.9.4</a>) from the objects. +</li> +<li> +<strong>Rescale</strong> (<a href="cmdRescale.html#cmdRescale">Section 2.2.1</a>) the selected objects. +</li> +</ul> +<p> +The <strong>Cut</strong>, <strong>Copy</strong>, <strong>Clone</strong> and <strong>Paste</strong> commands found on the <strong>Edit</strong> (<a href="editM.html#editM">Section 2.4</a>) menu will also operate on selected objects. +</p> +<p> +Notes: +</p> +<ul><li> +Connections between selected and unselected tracks will be broken when selected tracks are moved. If the Drawing Scale is 8:1 or smaller, these about-to-be broken connections are marked with a red X. +</li> +</ul> +<p> + +</p> +<ul><li> +During Move or Rotate operations, if an track end that will be disconnected during the operation comes close to a disconnected end of track that isn't selected, a pair of blue circles (one empty and one filled) will turn on. This shows that if the drag is stopped, those two points will be joined and the other selected tracks aligned. This represents a faster alternative to the <a href="joinTrackMove.html#joinTrackMove">Section 2.2.7.7</a> command. +</li> +</ul> +<p> + +</p> +<ul><li> +The <strong>Select All</strong> item on the Edit (<a href="editM.html#editM">Section 2.4</a>) menu can be used to select all objects on the layout. +</li> +</ul> +<p> + +</p> +<ul><li> +The Default Command radio button on the Command Options (<a href="cmdCmdopt.html#cmdCmdopt">Section 2.10.2</a>) dialog controls whether the <em>Properties</em> (<a href="cmdDescribe.html#cmdDescribe">Section 2.2.13</a>) or <em>Select</em> command is used as the default command. +</li> +</ul> +<p> + +</p> +<ul><li> +Pressing the <em>Escape</em> key will deselect all selected tracks. Alternatively left-clicking on an empty area will also work. +</li> +</ul> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Split Commands</title> +<link rel="previous" href="cmdSelect.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdSplitTrack.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdSplit"></a>2.2.17 Split Commands</h1> +<p> +There are two split commands, <a href="cmdSplitTrack.html#cmdSplitTrack">Section 2.2.17.1</a> and <a href="cmdSplitDraw.html#cmdSplitDraw">Section 2.2.17.3</a>. +</p> +<ul> +<li><a href="cmdSplitTrack.html#cmdSplitTrack">2.2.17.1 Split Track</a></li> +<li><a href="splitDisconnect.html#splitDisconnect">2.2.17.2 Disconnect Joint</a></li> +<ul> +<li><a href="splitDivide.html#splitDivide">2.2.17.2.1 Divide Track</a></li> +<li><a href="splitBlockGap.html#splitBlockGap">2.2.17.2.2 Adding Block Gaps</a></li> +</ul> +<li><a href="cmdSplitDraw.html#cmdSplitDraw">2.2.17.3 Split a Draw Object</a></li> +<li><a href="cmdTrimDraw.html#cmdTrimDraw">2.2.17.4 Trim a Draw Object using another Draw object</a></li> +</ul> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Split Track</title> +<link rel="previous" href="cmdSplit.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="splitDisconnect.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdSplitTrack"></a>2.2.17.1 Split Track</h1> +<p> +<img src="png.d/bsplit.png"> +</p> +<p> +The <strong>Split Track</strong> command provides several functions. It can be used to disconnect the joint between two sections of connected track, to divide a section of track into two pieces at a selected point or to place block gaps at an existing joint. +</p> +<p> +Until a split point is selected, the split point under the cursor will have a blue marker and if it is near a connected end a blue "X" will indicate that a split will occur. +</p> +<p> +For detail about; +</p> +<p> + +</p> +<dl><dd> +Disconnecting the joint between two sections of track see <a href="splitDisconnect.html#splitDisconnect">Section 2.2.17.2</a>. +</dd> +</dl> +<p> + +</p> +<dl><dd> +Dividing a section of flex-track into two connected pieces or trimming a turnout see <a href="splitDivide.html#splitDivide">Section 2.2.17.2.1</a>. +</dd> +</dl> +<p> + +</p> +<dl><dd> +Creating block gaps at an existing joint see <a href="splitBlockGap.html#splitBlockGap">Section 2.2.17.2.2</a>. +</dd> +</dl> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Disconnect Joint</title> +<link rel="previous" href="cmdSplitTrack.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="splitDivide.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="splitDisconnect"></a>2.2.17.2 Disconnect Joint</h1> +<p> +Disconnecting a joint between two pieces of connected track; +</p> +<ol><li> +Click the <strong>Split</strong> button (<img src="png.d/bsplit.png">) to activate the <strong>Split</strong> command. +</li> +<li> +Place the mouse pointer right over the joint between the two track endpoints (so the "X" is shown) then <em>Left-Click</em>. +</li> +<li> +A blue marker will show where a split will occur, but if the cursor is a near connected joint, it will show a blue "X". +<p> + +</p> + +</li> +</ol> +<dl><dd> +When the <strong>Split</strong> command completes, the joint at the two track endpoints will show three lines rather than one. The three lines represent abutted, disconnected track endpoints. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<img src="png.d/splitConnect.png"> +</dd> +<dd> +<em>Joint prior to split</em> +</dd> +</dl> +<p> + +</p> +<dl><dd> +<img src="png.d/splitDisconnect.png"> +</dd> +<dd> +<em>Joint following split</em> +</dd> +</dl> +<p> + +</p> +<p> +For detail about; +</p> +<p> + +</p> +<dl><dd> +Dividing a section of track into two connected pieces see <a href="splitDivide.html#splitDivide">Section 2.2.17.2.1</a>. +</dd> +</dl> +<p> + +</p> +<dl><dd> +Creating block gaps at an existing joint see <a href="splitBlockGap.html#splitBlockGap">Section 2.2.17.2.2</a>. +</dd> +</dl> +<hr> +<ul> +<li><a href="splitDivide.html#splitDivide">2.2.17.2.1 Divide Track</a></li> +<li><a href="splitBlockGap.html#splitBlockGap">2.2.17.2.2 Adding Block Gaps</a></li> +</ul> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Divide Track</title> +<link rel="previous" href="splitDisconnect.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="splitBlockGap.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="splitDivide"></a>2.2.17.2.1 Divide Track</h1> +<p> +Dividing a section of flex-track into two connected pieces; +</p> +<ol><li> +Click the <strong>Split Track</strong> button (<img src="png.d/bsplit.png">) to activate the <strong>Split Track</strong> command. +</li> +<li> +Place the mouse pointer over the point on the track where the it should be divided. A blue anchor bar across the track under the cursor will indicate the current split point. Then <em>Left-Click</em>. +</li> +<li> +To divide a Turnout, <em>Shift</em> must be held. The result will be a shorter Turnout with plain track replacing the rest of it. Note that the program will not stop division of the turnout between the switch blades and the frog - which would not be desireable in the real world. +<p> + +</p> + +</li> +</ol> +<dl><dd> +When the <strong>Split Track</strong> command completes, a connected joint will appear in the track at the point of selection. To split and disconnect at a point, execute the <strong>Split</strong> track command twice. The first command will split the track, the second command will disconnect it. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<img src="png.d/splitNotYet.png"> +</dd> +<dd> +<em>Track prior to split</em> +</dd> +</dl> +<p> + +</p> +<dl><dd> +<img src="png.d/splitConnect.png"> +</dd> +<dd> +<em>Track following split</em> +</dd> +</dl> +<p> + +</p> +<p> +It's not possible to create a track shorter than the <em>Minimum Track Length</em> (<a href="cmdPref.html#cmdPref">Section 2.10.7</a>). +</p> +<p> +This command is useful for placing tunnel portals or elevation points (<a href="cmdElevation.html#cmdElevation">Section 2.2.5</a>) at specific track locations. +</p> +<p> +Normally a turnout cannot be split however, if the <em>Shift</em> key is held when executing this command then the turnout can be <em>trim</em>med. <em>Trim</em>ming replaces the portion of track between the split point and the turnouts endpoint with flex-track. For turnouts with more than one set of points (<a href="generalTerms.html#generalTerms">Section B.2</a>), such as a slip switch or scissors crossover, a <em>trim</em> point cannot be selected between the <em>points</em> of the turnout. +</p> +<p> +For detail about; +</p> +<p> + +</p> +<dl><dd> +Disconnecting the joint between two sections of track see <a href="splitDisconnect.html#splitDisconnect">Section 2.2.17.2</a>. +</dd> +</dl> +<p> + +</p> +<dl><dd> +Creating block gaps at an existing joint see <a href="splitBlockGap.html#splitBlockGap">Section 2.2.17.2.2</a>. +</dd> +</dl> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Adding Block Gaps</title> +<link rel="previous" href="splitDivide.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdSplitDraw.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="splitBlockGap"></a>2.2.17.2.2 Adding <a name="i0"></a>Block Gaps</h1> +<p> +The <strong>Split</strong> command can be used to add block gaps (<a href="generalTerms.html#generalTerms">Section B.2</a>) at the point where two track endpoints join. Block gaps are drawn as a thick line and can be placed in either of the rails or both if total isolation is required. +</p> +<dl><dd> +<img src="png.d/blockNone.png"> +</dd> +<dd> +<em>No Block Gaps</em> +</dd> +</dl> +<p> + +</p> +<dl><dd> +<img src="png.d/blockTop.png"> +</dd> +<dd> +<em>Block Gap in top rail</em> +</dd> +</dl> +<p> + +</p> +<dl><dd> +<img src="png.d/blockBottom.png"> +</dd> +<dd> +<em>Block Gap in bottom rail</em> +</dd> +</dl> +<p> + +</p> +<dl><dd> +<img src="png.d/blockBoth.png"> +</dd> +<dd> +<em>Block Gaps in both rails</em> +</dd> +</dl> +<p> + +</p> +<p> +After starting the <strong>Split</strong> command use the <em>Shift+Right-Click</em> over a joint (with the blue "X" anchor showing) to display one of two pop-up menus which can be used to add, change or remove <em>block gaps</em> for the selected endpoint. +</p> +<dl><dd> +<img src="png.d/msplitblock.png"> +</dd> +<dd> +<em>This menu appears if track runs in a horizontal direction.</em> +</dd> +</dl> +<p> + +</p> +<dl><dd> +<img src="png.d/msplitblockLR.png"> +</dd> +<dd> +<em>This menu appears if track runs in a vertical direction.</em> +</dd> +</dl> +<p> + +</p> +<p> +For detail about; +</p> +<p> + +</p> +<dl><dd> +Disconnecting the joint between two sections of track see <a href="splitDisconnect.html#splitDisconnect">Section 2.2.17.2</a>. +</dd> +</dl> +<p> + +</p> +<dl><dd> +Dividing a section of track into two connected pieces see <a href="splitDivide.html#splitDivide">Section 2.2.17.2.1</a>. +</dd> +</dl> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Split a Draw Object</title> +<link rel="previous" href="splitBlockGap.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdTrimDraw.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdSplitDraw"></a>2.2.17.3 Split a Draw Object</h1> +<p> +The <strong>Split Draw</strong> command can be used to split many draw object (Straight Lines, Curved Lines, Circles, Polygons, PolyLines). +</p> +<p> +Until a split point is selected, the split point under the cursor will have a blue marker. +</p> +<ol><li> +If the object being split is a Polyline, the split will either result in a Straight Line and a PolyLine or two PolyLines depending on where the split is along the line. (PolyLines must always have at least 2 segments). +</li> +<li> +Filled Circles and Polygons will be unfilled after the split. +</li> +<li> +If the split object is a Circle, the result is an circular arc split at the point with a small (5 degree) gap. +</li> +<li> +If the split object is a Polygon, a PolyLine with two end points at the split results. +</li> +</ol> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Trim a Draw Object using another Draw object</title> +<link rel="previous" href="cmdSplitDraw.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdDraw.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdTrimDraw"></a>2.2.17.4 Trim a Draw Object using another Draw object</h1> +<p> +The <strong>Trim Draw</strong> command can be used to trim many draw objects (Straight Lines, Curved Lines, Circles, Polygons, PolyLines). Polygons and Circles are split into PolyLines and Curves. +</p> +<ol><li> +First a Trimming object (draw object) is selected with <strong>Left-Click</strong>. Until the trim draw object is selected, a draw object under the cursor will be highlit in blue. Once it is selected it will be highlit in the current Select Color. +</li> +<li> +Next the point of intersection between the trim object and an object to be trimmed is selected. Until a split point is selected, a suitable split point under the cursor will have a blue trim anchor that is a T shape aligned with the trimming object. +</li> +</ol> +<p> +The trim anchor base has an arm that indicates which side of the trimmed object will be deleted. A <strong>Left-Click</strong> will trim the object. +</p> +<p> + +</p> +<p> +If the trimmed object is a circle or a polygon, the result will be the same as a Split (<a href="cmdSplitDraw.html#cmdSplitDraw">Section 2.2.17.3</a>), a 355 degree circle and an open polyline with ends at the split will result. +</p> +<p> +Once a trim has occured, the trimming object remains selected for another trim. +</p> +<p> +To leave the command use the spacebar. If <em>Sticky</em> (<a href="cmdSticky.html#cmdSticky">Section 2.10.8</a>) is set for Split commands you will be able to select another trim object. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Draw Menu</title> +<link rel="previous" href="cmdTrimDraw.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdDrawCircles.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdDraw"></a>2.3 <a name="i0"></a>Draw Menu</h1> +<p> +<em>Draw</em> commands are used to draw lines, arcs and other shapes. These can be used to represent water edges, bridges and other scenic features. +</p> +<p> +<img src="png.d/bdraw.png"> +</p> +<p> +There are 4 command buttons on the tool-bar used to draw Straight Objects, Curved Lines, Circles and other Shapes. Each command button is followed by a button that changes the action (and Icon) on the command button. +</p> +<p> +<img src="png.d/mdraw.png"> +</p> +<p> +Functions for drawing basic shapes and objects like lines and curves can be accessed from this menu. +</p> +<dl><dd> +<strong>Circle Lines</strong> - draw empty or filled circles. (<a href="cmdDrawCircles.html#cmdDrawCircles">Section 2.3.1</a>) +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Curved Lines</strong> - are created in the same manner as curved tracks. (<a href="cmdDrawCurves.html#cmdDrawCurves">Section 2.3.2</a>) +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Note</strong> - attach a note icon to a specific location on the layout. (<a href="cmdNote.html#cmdNote">Section 2.3.3</a>) +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Ruler</strong> - create ruler and set visibility (<a href="cmdRuler.html#cmdRuler">Section 2.3.4</a>) +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Protractor</strong> - create protractor and set visibility (<a href="cmdAngle.html#cmdAngle">Section 2.3.5</a>) +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Shapes</strong> - draw boxes, polygons and poly-lines. (<a href="cmdDrawShapes.html#cmdDrawShapes">Section 2.3.6</a>) +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Straight Objects</strong> - draw straight objects. (<a href="cmdDrawStraight.html#cmdDrawStraight">Section 3.3.3.5</a>) +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Text</strong> - allows entry of text directly onto the layout. (<a href="cmdText.html#cmdText">Section 2.3.9</a>) +</dd> +</dl> +<p> +Some commands display controls on the Status Line (<a href="mainW.html#mainW">Section 3.1</a>) to change line width, color or other attributes of the object. +</p> +<hr> +<ul> +<li><a href="cmdDrawCircles.html#cmdDrawCircles">2.3.1 Circles and Filled Circles</a></li> +<ul> +<li><a href="cmdDrawCircleTangent.html#cmdDrawCircleTangent">2.3.1.1 Draw Circle from Tangent</a></li> +<li><a href="cmdDrawCircleCenter.html#cmdDrawCircleCenter">2.3.1.2 Draw Circle from Center</a></li> +<li><a href="cmdDrawFilledCircleTangent.html#cmdDrawFilledCircleTangent">2.3.1.3 Draw Filled Circle from Tangent</a></li> +<li><a href="cmdDrawFilledCircleCenter.html#cmdDrawFilledCircleCenter">2.3.1.4 Draw Filled Circle from Center</a></li> +</ul> +<li><a href="cmdDrawCurves.html#cmdDrawCurves">2.3.2 Curved Lines</a></li> +<ul> +<li><a href="cmdDrawCurveEndPt.html#cmdDrawCurveEndPt">2.3.2.1 Draw Curve from End Point</a></li> +<li><a href="cmdDrawCurveTangent.html#cmdDrawCurveTangent">2.3.2.2 Draw Curve from Tangent</a></li> +<li><a href="cmdDrawCurveCenter.html#cmdDrawCurveCenter">2.3.2.3 Draw Curve from Center</a></li> +<li><a href="cmdDrawCurveChord.html#cmdDrawCurveChord">2.3.2.4 Draw Curve from Chord</a></li> +<li><a href="cmdDrawBezierCurve.html#cmdDrawBezierCurve">2.3.2.5 Draw Bezier Curve</a></li> +</ul> +<li><a href="cmdNote.html#cmdNote">2.3.3 Note Variants</a></li> +<ul> +<li><a href="cmdTextNote.html#cmdTextNote">2.3.3.1 Text Note</a></li> +<li><a href="cmdLinkNote.html#cmdLinkNote">2.3.3.2 Weblink</a></li> +<li><a href="cmdFileNote.html#cmdFileNote">2.3.3.3 Document</a></li> +</ul> +<li><a href="cmdRuler.html#cmdRuler">2.3.4 Ruler</a></li> +<li><a href="cmdAngle.html#cmdAngle">2.3.5 Protractor</a></li> +<li><a href="cmdDrawShapes.html#cmdDrawShapes">2.3.6 Draw Shapes</a></li> +<ul> +<li><a href="cmdDrawBox.html#cmdDrawBox">2.3.6.1 Draw Box</a></li> +<li><a href="cmdDrawFilledBox.html#cmdDrawFilledBox">2.3.6.2 Draw Filled Box</a></li> +<li><a href="cmdDrawPolygon.html#cmdDrawPolygon">2.3.6.3 Draw Polygon</a></li> +<li><a href="cmdDrawFilledPolygon.html#cmdDrawFilledPolygon">2.3.6.4 Draw Filled Polygon</a></li> +<li><a href="cmdDrawPolyline.html#cmdDrawPolyline">2.3.6.5 Draw PolyLine</a></li> +</ul> +<li><a href="cmdDrawStraights.html#cmdDrawStraights">2.3.7 Straight Objects</a></li> +<ul> +<li><a href="cmdDrawLine.html#cmdDrawLine">2.3.7.1 Draw Straight Line</a></li> +<li><a href="cmdDrawDimLine.html#cmdDrawDimLine">2.3.7.2 Draw Dimension Line</a></li> +<li><a href="cmdDrawBench.html#cmdDrawBench">2.3.7.3 Draw Benchwork</a></li> +<li><a href="cmdDrawTableEdge.html#cmdDrawTableEdge">2.3.7.4 Draw Table Edge</a></li> +</ul> +<li><a href="DrawOrigin.html#DrawOrigin">2.3.8 Draw Objects Origin</a></li> +<li><a href="cmdText.html#cmdText">2.3.9 Text</a></li> +</ul> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Circles and Filled Circles</title> +<link rel="previous" href="cmdDraw.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdDrawCircleTangent.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdDrawCircles"></a>2.3.1 <a name="i0"></a>Circles and Filled Circles</h1> +<p> +<img src="png.d/mdrawcircles.png"> +</p> +<p> +Before a Circle is drawn its line width and color can be set. For Filled Circles, the color can be set. The <strong>Circle Line Width</strong> field is a scaled dimension in inches if >0. If 0 it is a 1 pixel wide line at all zooms. If the value is negative, it is a scale-independent number of pixels wide. +</p> +<p> +<strong>Circles</strong> and <strong>Filled Circles</strong> are created by selecting either the center position or a point on the edge of the circle and dragging to specify the radius. +</p> +<dl><dd> +<a href="cmdDrawCircleTangent.html#cmdDrawCircleTangent">Section 2.3.1.1</a>. Draw a Circle from the Edge. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<a href="cmdDrawCircleCenter.html#cmdDrawCircleCenter">Section 2.3.1.2</a>. Draw a Circle from the Center. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<a href="cmdDrawFilledCircleTangent.html#cmdDrawFilledCircleTangent">Section 2.3.1.3</a>. Draw a Filled Circle from the Edge. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<a href="cmdDrawFilledCircleCenter.html#cmdDrawFilledCircleCenter">Section 2.3.1.4</a>. Draw a Filled Circle from the Center. +</dd> +</dl> +<hr> +<ul> +<li><a href="cmdDrawCircleTangent.html#cmdDrawCircleTangent">2.3.1.1 Draw Circle from Tangent</a></li> +<li><a href="cmdDrawCircleCenter.html#cmdDrawCircleCenter">2.3.1.2 Draw Circle from Center</a></li> +<li><a href="cmdDrawFilledCircleTangent.html#cmdDrawFilledCircleTangent">2.3.1.3 Draw Filled Circle from Tangent</a></li> +<li><a href="cmdDrawFilledCircleCenter.html#cmdDrawFilledCircleCenter">2.3.1.4 Draw Filled Circle from Center</a></li> +</ul> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Draw Circle from Tangent</title> +<link rel="previous" href="cmdDrawCircles.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdDrawCircleCenter.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdDrawCircleTangent"></a>2.3.1.1 <a name="i0"></a>Draw Circle from Tangent</h1> +<p> +<img src="png.d/dcircle3.png"> +</p> +<p> +<code>Left-Drag</code> a point from the edge of the circle to the center to specify the radius. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Draw Circle from Center</title> +<link rel="previous" href="cmdDrawCircleTangent.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdDrawFilledCircleTangent.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdDrawCircleCenter"></a>2.3.1.2 <a name="i0"></a>Draw Circle from Center</h1> +<p> +<img src="png.d/dcircle2.png"> +</p> +<p> +<code>Left-Drag</code> from the center of the circle to the edge to specify the radius. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Draw Filled Circle from Tangent</title> +<link rel="previous" href="cmdDrawCircleCenter.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdDrawFilledCircleCenter.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdDrawFilledCircleTangent"></a>2.3.1.3 <a name="i0"></a>Draw Filled Circle from Tangent</h1> +<p> +<img src="png.d/dflcrcl3.png"> +</p> +<p> +<code>Left-Drag</code> from the edge of the circle to the center to specify the radius. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Draw Filled Circle from Center</title> +<link rel="previous" href="cmdDrawFilledCircleTangent.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdDrawCurves.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdDrawFilledCircleCenter"></a>2.3.1.4 <a name="i0"></a>Draw Filled Circle from Center</h1> +<p> +<img src="png.d/dflcrcl2.png"> +</p> +<p> +<code>Left-Drag</code> a point from the center to the edge of the circle to specify the radius. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Curved Lines</title> +<link rel="previous" href="cmdDrawFilledCircleCenter.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdDrawCurveEndPt.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdDrawCurves"></a>2.3.2 <a name="i0"></a>Curved Lines</h1> +<p> +<img src="png.d/mdrawcurve.png"> +</p> +<p> +Before a Curved Line is created, its width and color can be set. The <strong>Curved Line Width</strong> or <strong>Bezier Line Width</strong> field is a scaled dimension in inches if >0. If 0 it is a 1 pixel wide line at all zooms. If the value is negative, it is a scale-independent number of pixels wide. +</p> +<p> +<strong>Curved Lines</strong> are created in the same manner as curved tracks. +</p> +<dl><dd> +(<a href="cmdDrawCurveEndPt.html#cmdDrawCurveEndPt">Section 2.3.2.1</a>). Drag out the end point and then curve it. +</dd> +</dl> +<p> + +</p> +<dl><dd> +(<a href="cmdDrawCurveCenter.html#cmdDrawCurveCenter">Section 2.3.2.3</a>). Select the center and then an endpoint and drag out the curve. +</dd> +</dl> +<p> + +</p> +<dl><dd> +(<a href="cmdDrawCurveTangent.html#cmdDrawCurveTangent">Section 2.3.2.2</a>). Select the end and drag out the center. +</dd> +</dl> +<p> + +</p> +<dl><dd> +(<a href="cmdDrawCurveChord.html#cmdDrawCurveChord">Section 2.3.2.4</a>). Drag from one end of the curve to the other to form the chord of the curve. +</dd> +</dl> +<p> + +</p> +<dl><dd> +(<a href="cmdDrawBezierCurve.html#cmdDrawBezierCurve">Section 2.3.2.5</a> <img src="png.d/dbezier.png"> <em>Left-Drag</em> out control point from one end of the curve and then <em>Left-Drag</em> out the second control point from the other end. +</dd> +</dl> +<p> +If <strong>MagneticSnap</strong> (<a href="cmdMagneticSnap.html#cmdMagneticSnap">Section 2.12.1</a>) is enabled, the curve ends will snap to the nearest part of nearby Draw objects unless <em>Alt</em> is held. If Magnetic Snap is disabled, snapping to objects will only occur if <em>Alt</em> is held. +</p> +<p> +If <strong>Grid Snap</strong> is on and magnetic snap does not find a draw object, the curve ends will snap to the grid. <em>Alt</em> suppresses this snap. +</p> +<p> +If <em>Sticky</em> is set for curved line objects, after the curve is drawn there will be two text fields on the bottom rail, to allow fine-tuning of the radius and the arc angle. Pressing <code>Enter</code> or <code>Tab</code> with the cursor in these boxes will apply the new values to the curve. Pressing <code>Space</code> or <code>Enter</code> or <code>Tab</code> on the drawing surface will move to drawing a new curve. Pressing <code>Shift+Tab</code> with the cursor on the drawing surface will remove the current curve, but allow a new curve to be drawn. Even if <code>Esc</code> is pressed, the curve will already exist, it can be removed with <strong>Undo</strong>. +</p> +<p> +To adjust the curve with the mouse, <em>Left-Click</em> and <em>Left-Drag</em> an end or a the radius. Hit <em>Enter</em> or <em>Space</em> to accept, <em>Esc</em> to reject. +</p> +<hr> +<ul> +<li><a href="cmdDrawCurveEndPt.html#cmdDrawCurveEndPt">2.3.2.1 Draw Curve from End Point</a></li> +<li><a href="cmdDrawCurveTangent.html#cmdDrawCurveTangent">2.3.2.2 Draw Curve from Tangent</a></li> +<li><a href="cmdDrawCurveCenter.html#cmdDrawCurveCenter">2.3.2.3 Draw Curve from Center</a></li> +<li><a href="cmdDrawCurveChord.html#cmdDrawCurveChord">2.3.2.4 Draw Curve from Chord</a></li> +<li><a href="cmdDrawBezierCurve.html#cmdDrawBezierCurve">2.3.2.5 Draw Bezier Curve</a></li> +</ul> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Draw Curve from End Point</title> +<link rel="previous" href="cmdDrawCurves.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdDrawCurveTangent.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdDrawCurveEndPt"></a>2.3.2.1 <a name="i0"></a>Draw Curve from End Point</h1> +<p> +<img src="png.d/dcurve1.png"> +</p> +<p> +<code>Left-drag</code> from the start of the curve and drag in the direction of the curve. Then <code>left-drag</code> to form the curve. +</p> +<p> +If the cursor is over a Draw object and <strong>MagneticSnap</strong> (<a href="cmdMagneticSnap.html#cmdMagneticSnap">Section 2.12.1</a>) is on, the first position will snap to the nearest part of that object. If <em>Alt</em> is held the snap will be suppressed. If <strong>MagneticSnap</strong> is disabled, the snap will happen if <em>Alt</em> is held. If <strong>GridSnap</strong> is enabled and MagneticSnap does not find a postion, the first position will snap to the Grid. This is suppressed if <strong>Alt</strong> is held. The second end will act similarly. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Draw Curve from Tangent</title> +<link rel="previous" href="cmdDrawCurveEndPt.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdDrawCurveCenter.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdDrawCurveTangent"></a>2.3.2.2 <a name="i0"></a>Draw Curve from Tangent</h1> +<p> +<img src="png.d/dcurve2.png"> +</p> +<p> +Select one end of the curve and <code>left-drag</code> to the center. Then <code>left-drag</code> the curve around the center. +</p> +<p> +The first and second ends will act like <a href="cmdDrawCurveEndPt.html#cmdDrawCurveEndPt">Section 2.3.2.1</a> with <strong>MagneticSnap</strong> (<a href="cmdMagneticSnap.html#cmdMagneticSnap">Section 2.12.1</a>) unless <em>Alt</em> is held. If <strong>GridSnap</strong> is enabled and MagneticSnap does not find a postion, the first position will snap to the Grid. This is suppressed if <strong>Alt</strong> is held. +</p> +<p> +To complete the command, drag on the red arrows to adjust the curve from the initial end. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Draw Curve from Center</title> +<link rel="previous" href="cmdDrawCurveTangent.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdDrawCurveChord.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdDrawCurveCenter"></a>2.3.2.3 <a name="i0"></a>Draw Curve from Center</h1> +<p> +<img src="png.d/dcurve3.png"> +</p> +<p> +Select the center of the curve and <code>left-drag</code> to one end. If <strong>GridSnap</strong> is enabled, the first position will snap to the Grid. This is suppressed if <strong>Alt</strong> is held. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Draw Curve from Chord</title> +<link rel="previous" href="cmdDrawCurveCenter.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdDrawBezierCurve.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdDrawCurveChord"></a>2.3.2.4 <a name="i0"></a>Draw Curve from Chord</h1> +<p> +<img src="png.d/dcurve4.png"> +</p> +<p> +<code>Left-drag</code> from one end of the curve to the other to form the chord of the curve. +</p> +<p> +The first and second ends will act like <a href="cmdDrawCurveEndPt.html#cmdDrawCurveEndPt">Section 2.3.2.1</a> with <strong>MagneticSnap</strong> (<a href="cmdMagneticSnap.html#cmdMagneticSnap">Section 2.12.1</a>) and <strong>SnapGrid</strong> unless <em>Alt</em> is held. +</p> +<p> +If the mouse is over a draw object the second position will snap to the nearst part of that object. If <em>Shift</em> is held the snap will be suppressed. +</p> +<p> +To complete the command, drag on the red arrows to adjust the curve. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Draw Bezier Curve</title> +<link rel="previous" href="cmdDrawCurveChord.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdNote.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdDrawBezierCurve"></a>2.3.2.5 <a name="i0"></a>Draw Bezier Curve</h1> +<p> +<img src="png.d/dbezier.png"> +</p> +<p> +<em>Left-Drag</em> out control point from one end of the curve and then <em>Left-Drag</em> out the second control point from the other end. Repeat for the other end and control point. +</p> +<p> +The first and second ends will act like <a href="cmdDrawCurveEndPt.html#cmdDrawCurveEndPt">Section 2.3.2.1</a> with <strong>MagneticSnap</strong> and <strong>SnapGrid</strong> unless <em>Alt</em> is held. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Note Variants</title> +<link rel="previous" href="cmdDrawBezierCurve.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdTextNote.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdNote"></a>2.3.3 <a name="i0"></a>Note Variants</h1> +<p> +<img src="png.d/mnote.png"> +</p> +<p> +The <strong>Note</strong> command allows you to +</p> +<dl><dd> +Attach <strong>plain text notes</strong> (<a href="cmdTextNote.html#cmdTextNote">Section 2.3.3.1</a>), +</dd> +</dl> +<p> + +</p> +<dl><dd> +Attach <strong>weblinks</strong> (<a href="cmdLinkNote.html#cmdLinkNote">Section 2.3.3.2</a>) or +</dd> +</dl> +<p> + +</p> +<dl><dd> +Attach <strong>document references</strong> (<a href="cmdFileNote.html#cmdFileNote">Section 2.3.3.3</a>) to selected places on the layout. +</dd> +</dl> +<hr> +<ul> +<li><a href="cmdTextNote.html#cmdTextNote">2.3.3.1 Text Note</a></li> +<li><a href="cmdLinkNote.html#cmdLinkNote">2.3.3.2 Weblink</a></li> +<li><a href="cmdFileNote.html#cmdFileNote">2.3.3.3 Document</a></li> +</ul> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Text Note</title> +<link rel="previous" href="cmdNote.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdLinkNote.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdTextNote"></a>2.3.3.1 <a name="i0"></a>Text Note</h1> +<p> +<img src="png.d/bnote.png"> <img src="png.d/iconnote.png"> Click and drag on the Main Canvas (<a href="mainW.html#mainW">Section 3.1</a>) to place the note. +</p> +<p> +When you release, the <em>Note Editor</em> dialog is displayed. You can enter the note in the text area. Text is limited to about 10 thousand characters. +</p> +<p> +<img src="png.d/notetext.png"> +</p> +<p> +When in <strong>Properties</strong> (<a href="cmdDescribe.html#cmdDescribe">Section 2.2.13</a>) mode, clicking on a <em>Note</em> will display the <em>Property Sheet</em> to let you read or modify the note. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Weblink</title> +<link rel="previous" href="cmdTextNote.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdFileNote.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdLinkNote"></a>2.3.3.2 <a name="i0"></a>Weblink</h1> +<p> +<img src="png.d/blink.png"> <img src="png.d/iconlink.png"> Similar to text notes you can place a weblink on the layout. +</p> +<p> +After releasing the mouse button, the <em>Link Editor</em> dialog is displayed. +</p> +<p> +<img src="png.d/notelink.png"> +</p> +<p> +You can enter the URL of the website and a short description. When clicking on the Open button, your default browser is used to display the website. +</p> +<p> +When in <strong>Properties</strong> (<a href="cmdDescribe.html#cmdDescribe">Section 2.2.13</a>) mode, clicking on a <em>Weblink Note</em> will display the <em>Property Sheet</em> to let you read or modify the URL or the description. +</p> +<p> +Double clicking on a weblink icon opens the website in your default browser. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Document</title> +<link rel="previous" href="cmdLinkNote.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdRuler.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdFileNote"></a>2.3.3.3 <a name="i0"></a>Document</h1> +<p> +<img src="png.d/bfile.png"> <img src="png.d/iconfile.png"> Similar to text notes you can place a reference to a file on the layout. +</p> +<p> +After releasing the mouse button, the <em>Document Editor</em> dialog is displayed. +</p> +<p> +<img src="png.d/notefile.png"> +</p> +<p> +You can select the file and a enter a short description. When clicking on the Open button the file is opened with the default program for that file type. +</p> +<p> +When in <strong>Properties</strong> (<a href="cmdDescribe.html#cmdDescribe">Section 2.2.13</a>) mode, clicking on a <em>Document Note</em> will display the <em>Property Sheet</em> to let you read or modify the filename or the description. +</p> +<p> +Double clicking on a document reference icon opens the document in the default program. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Ruler</title> +<link rel="previous" href="cmdFileNote.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdAngle.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdRuler"></a>2.3.4 <a name="i0"></a>Ruler</h1> +<p> +<img src="png.d/bruler.png"> +</p> +<p> +The <strong>Ruler</strong> command displays a ruler on the layout. Click where you want the ruler to begin and drag the cursor to measure distances from the origin. The measured length is displayed in the <strong>Status-bar</strong> (<a href="mainW.html#mainW">Section 3.1</a>). +</p> +<p> +You can use the <strong>Modify</strong> (<a href="cmdModify.html#cmdModify">Section 2.2.8</a>) command to change the length of the <strong>Ruler</strong>. +</p> +<p> +Subsequent clicks on the <strong>Ruler</strong> button will hide or display the ruler. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Protractor</title> +<link rel="previous" href="cmdRuler.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdDrawShapes.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdAngle"></a>2.3.5 <a name="i0"></a>Protractor</h1> +<p> +<img src="png.d/bangle.png"> +</p> +<p> +The <strong>Angle</strong> command displays a <em>Protractor</em> on the layout. Click for the protractor origin and <code>left-drag</code> the cursor to set the base angle. Adding <code>Ctrl</code> will snap the angle to a multiple of 90 degrees. +</p> +<p> +Then {Left-Drag the second line. Adding <code>Ctrl</code> will snap the angle to 90 degree relative to the base line. The angle between the lines is displayed. +</p> +<p> +Sunsequent clicks on the <strong>Angle</strong> button will hide or display the <em>Protractor</em>. +</p> +<p> +The points of the <em>Protractor</em> can be modified using the <strong>Modify</strong> (<a href="cmdModify.html#cmdModify">Section 2.2.8</a>) command. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Draw Shapes</title> +<link rel="previous" href="cmdAngle.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdDrawBox.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdDrawShapes"></a>2.3.6 <a name="i0"></a>Draw Shapes</h1> +<p> +<img src="png.d/mdrawshapes.png"> +</p> +<p> +Shapes are drawn by: +</p> +<dl><dd> +(<a href="cmdDrawBox.html#cmdDrawBox">Section 2.3.6.1</a>). Boxes +</dd> +</dl> +<p> + +</p> +<dl><dd> +(<a href="cmdDrawFilledBox.html#cmdDrawFilledBox">Section 2.3.6.2</a>. Filled Boxes +</dd> +</dl> +<p> + +</p> +<dl><dd> +(<a href="cmdDrawPolygon.html#cmdDrawPolygon">Section 2.3.6.3</a>. Polygons +</dd> +</dl> +<p> + +</p> +<dl><dd> +(<a href="cmdDrawFilledPolygon.html#cmdDrawFilledPolygon">Section 2.3.6.4</a>. Filled Polygons +</dd> +</dl> +<p> + +</p> +<dl><dd> +(<a href="cmdDrawPolyline.html#cmdDrawPolyline">Section 2.3.6.5</a>. PolyLines +</dd> +</dl> +<p> + +</p> +<p> +If <em>Sticky</em> is set for many draw line and curve objects, after the object is created, precise dimensions can be entered to alter the new object, before it is completed either with a <code>Space</code> or <code>Return</code> or <code>Tab</code> or by selecting a new operation. +</p> +<p> +The <strong>Polygon</strong> and <strong>PolyLine</strong> shapes are finished by pressing the <code>Space</code> or <code>Return</code> <code>Tab</code> key or by selecting another operation. Before they are finished, precise dimensions can be entered for the last side drawn. All Polylines and Polygons must have more than 2 corners to be created successfully. +</p> +<p> +Note that <a href="cmdModify.html#cmdModify">Section 2.2.8</a> can be used on a Polygon or a Polyline after it has been finished to alter individual points and to make them curved or rounded points. +</p> +<hr> +<ul> +<li><a href="cmdDrawBox.html#cmdDrawBox">2.3.6.1 Draw Box</a></li> +<li><a href="cmdDrawFilledBox.html#cmdDrawFilledBox">2.3.6.2 Draw Filled Box</a></li> +<li><a href="cmdDrawPolygon.html#cmdDrawPolygon">2.3.6.3 Draw Polygon</a></li> +<li><a href="cmdDrawFilledPolygon.html#cmdDrawFilledPolygon">2.3.6.4 Draw Filled Polygon</a></li> +<li><a href="cmdDrawPolyline.html#cmdDrawPolyline">2.3.6.5 Draw PolyLine</a></li> +</ul> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Draw Box</title> +<link rel="previous" href="cmdDrawShapes.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdDrawFilledBox.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdDrawBox"></a>2.3.6.1 <a name="i0"></a>Draw Box</h1> +<p> +<img src="png.d/dbox.png"> +</p> +<p> +Before the box is drawn, the line width and color can be specified. The <strong>Box Line Width</strong> field is a scaled dimension in inches if >0. If 0 it is a 1 pixel wide line at all zooms. If the value is negative, it is a scale-independent number of pixels wide. +</p> +<p> +<strong>Boxes</strong> are created by selecting one corner and dragging the opposite corner. +</p> +<p> + +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Draw Filled Box</title> +<link rel="previous" href="cmdDrawBox.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdDrawPolygon.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdDrawFilledBox"></a>2.3.6.2 <a name="i0"></a>Draw Filled Box</h1> +<p> +<img src="png.d/dfilbox.png"> +</p> +<p> +<strong>Filled Boxes</strong> are created by selecting one corner and dragging the opposite corner. +</p> +<p> + +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Draw Polygon</title> +<link rel="previous" href="cmdDrawFilledBox.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdDrawFilledPolygon.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdDrawPolygon"></a>2.3.6.3 <a name="i0"></a>Draw Polygon</h1> +<p> +<img src="png.d/dpoly.png"> +</p> +<p> +Before the polygon is started the line width and color can be set. The <strong>PolyGon Line Width</strong> field is a scaled dimension in inches if >0. If 0 it is a 1 pixel wide line at all zooms. If the value is negative, it is a scale-independent number of pixels wide. +</p> +<p> +<strong>Polygons</strong> are created by either a series for <code>Left-Click</code>s or <code>Left+Drag</code>s, and a new "node" is placed for each. When using <code>Left-drag</code>, the node will be positioned when you release the button. +</p> +<dl><dd> +If <strong>MagneticSnap</strong> (<a href="cmdMagneticSnap.html#cmdMagneticSnap">Section 2.12.1</a>) is enabled, An anchor point will be shown on nearby draw objects that the next point will be snapped to unless <code>Alt</code> is held. +</dd> +<dd> +If it is disabled, the snap will only occur if <em>Alt</em> is held. +</dd> +<dd> +If <code>Ctrl</code> is held down when a new point is placed, it will snap the relative angle of the new side to a multiple of 90 degrees from the previous side. On the first polygon side this will be at a multiple of 90 degrees to the axes. The line from the previous point will be highlighted in Blue. +</dd> +<dd> +A special blue square anchor will show when the cursor is in a position such that it is 90 degrees away from both the last point and the first point of the Polygon. +</dd> +<dd> +The last polygon segment dimensions can be altered using the text boxes that appear showing the segment length and the relative angle to the previous segment. +</dd> +<dd> +A polygon is closed if the next node is place over the start of the polygon +</dd> +<dd> +The polygon is ended using <code>Enter</code> or <code>Space</code>. The polygon will be auto-closed. +</dd> +</dl> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Draw Filled Polygon</title> +<link rel="previous" href="cmdDrawPolygon.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdDrawPolyline.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdDrawFilledPolygon"></a>2.3.6.4 <a name="i0"></a>Draw Filled Polygon</h1> +<p> +<img src="png.d/dfilbox.png"> +</p> +<p> +Before the Polygon is started, the fill color can be set. +</p> +<p> +<strong>Filled Polygons</strong> are created by either a series for <code>Left-Click</code>s or <code>Left+Drag</code>s, and a new "node" is placed for each. When using <code>Left-drag</code>, the node will be positioned when you release the button. +</p> +<dl><dd> +The fill color can be adjusted using the color control at the bottom of the window +</dd> +<dd> +If <strong>MagneticSnap</strong> (<a href="cmdMagneticSnap.html#cmdMagneticSnap">Section 2.12.1</a>) is enabled, An anchor point will be shown on nearby draw objects that the next point will be snapped to unless <code>Alt</code> is held. +</dd> +<dd> +If it is disabled, the snap will only occur if <em>Alt</em> is held. +</dd> +<dd> +If <code>Ctrl</code> is held down when a new point is placed, it will snap the relative angle of the new side to a multiple of 90 degrees from the previous side. +</dd> +</dl> +<p> +On the first polygon side this will be at a multiple of 90 degrees to the axes. The line from the previous point will be highlighted in Blue. +</p> +<dl><dd> +A special blue square anchor will show when the cursor is in a position such that it is 90 degrees away from both the last point and the first point of the Polygon. +</dd> +<dd> +The last polygon segment dimensions can be altered using the text boxes that appear showing the segment length and the relative angle to the previous segment. +</dd> +<dd> +The polygon is closed if the next node is place over the start of the polygon +</dd> +<dd> +The Filled Polygon is ended using <code>Enter</code> or <code>Space</code>. The polygon will be auto-closed. +</dd> +</dl> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Draw PolyLine</title> +<link rel="previous" href="cmdDrawFilledPolygon.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdDrawStraights.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdDrawPolyline"></a>2.3.6.5 <a name="i0"></a>Draw PolyLine</h1> +<p> +<img src="png.d/dpolylin.png"> +</p> +<p> +Before the polygon is started the line width and color can be set. The <strong>Polyline Line Width</strong> field is a scaled dimension in inches if >0. If 0 it is a 1 pixel wide line at all zooms. If the value is negative, it is a scale-independent number of pixels wide. +</p> +<p> +<strong>PolyLines</strong> are created by either a series for <code>Left-Click</code>s or <code>Left+Drag</code>s, and a new "node" is placed for each. When using <code>left-drag</code>, the node will be positioned when you release the button. +</p> +<dl><dd> +If <strong>MagneticSnap</strong> (<a href="cmdMagneticSnap.html#cmdMagneticSnap">Section 2.12.1</a>) is enabled, An anchor point will be shown on nearby draw objects that the next point will be snapped to unless <code>Alt</code> is held. +</dd> +<dd> +If it is disabled, the snap will only occur if <em>Alt</em> is held. +</dd> +<dd> +If <code>Ctrl</code> is held down when a new point is placed, it will snap the relative angle of the new side to a multiple of 90 degrees from the previous side. On the first polyline segemnt this will be at a multiple of 90 degrees to the axes. The line from the previous point will be highlighted in Blue. +</dd> +<dd> +A special blue square anchor will show when the cursor is in a position such that it is 90 degrees away from both the last point and the first point of the Polyline. +</dd> +<dd> +The last drawn polyline segment dimensions can be altered using the text boxes that appear showing the segment length and the relative angle to the previous segment. +</dd> +<dd> +The polyline is ended using <code>Enter</code> or <code>Space</code>. +</dd> +<dd> +While drawing the Polyline certain short cuts are available by keystroke and via the Context Menu: +</dd> +<dd> +<code>'p'</code> - to cover to a Polygon +</dd> +<dd> +<code>'s'</code> - to smooth the last selected point +</dd> +<dd> +<code>'r'</code> - to make the last selected point round +</dd> +<dd> +<code>'v'</code> - to make the last selected point sharp (a vertex) +</dd> +<dd> +<code>'o'</code> - to change to <a href="DrawOrigin.html#DrawOrigin">Section 2.3.8</a> mode +</dd> +</dl> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Straight Objects</title> +<link rel="previous" href="cmdDrawPolyline.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdDrawLine.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdDrawStraights"></a>2.3.7 <a name="i0"></a>Straight Objects</h1> +<p> +<img src="png.d/mdrawstraight.png"> +</p> +<p> +Straight Objects are created by a <em>Left+Drag</em> (<a href="windowTerms.html#windowTerms">Section B.1</a>) on the layout. +</p> +<dl><dd> +(<a href="cmdDrawLine.html#cmdDrawLine">Section 2.3.7.1</a>). Creates a Straight Line +</dd> +</dl> +<p> + +</p> +<dl><dd> +(<a href="cmdDrawDimLine.html#cmdDrawDimLine">Section 2.3.7.2</a>). Creates a <strong>Dimension Line</strong> of various sizes. +</dd> +</dl> +<p> + +</p> +<dl><dd> +(<a href="cmdDrawBench.html#cmdDrawBench">Section 2.3.7.3</a>). Creates <a name="i1"></a>Bench-work using different types and orientation of lumber. +</dd> +</dl> +<p> + +</p> +<dl><dd> +(<a href="cmdDrawTableEdge.html#cmdDrawTableEdge">Section 2.3.7.4</a>). Creates a <strong>Table Edge</strong> +</dd> +</dl> +<ul> +<li><a href="cmdDrawLine.html#cmdDrawLine">2.3.7.1 Draw Straight Line</a></li> +<li><a href="cmdDrawDimLine.html#cmdDrawDimLine">2.3.7.2 Draw Dimension Line</a></li> +<li><a href="cmdDrawBench.html#cmdDrawBench">2.3.7.3 Draw Benchwork</a></li> +<li><a href="cmdDrawTableEdge.html#cmdDrawTableEdge">2.3.7.4 Draw Table Edge</a></li> +</ul> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Draw Straight Line</title> +<link rel="previous" href="cmdDrawStraights.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdDrawDimLine.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdDrawLine"></a>2.3.7.1 <a name="i0"></a>Draw Straight Line</h1> +<p> +<img src="png.d/dline.png"> +</p> +<p> +Creates a <strong>Straight Line</strong> of specified color and width. The <strong>Straight Line Width</strong> field is a scaled dimension in 75ths of an inch if >0. If 0 it is a 1 pixel wide line at all zooms. If the value is negative, it is a scale-independent number of pixels wide. +</p> +<p> +If <code>Ctrl</code> is held down during <code>Left+Drag</code> the line will snap the angle of the new side to a multiple of 90 degrees. +</p> +<p> +With <strong>MagneticSnap</strong> (<a href="cmdMagneticSnap.html#cmdMagneticSnap">Section 2.12.1</a>) enabled, the new line start position will snap to the nearest draw object, as shown by the anchor. If <code>Alt</code> is held down, the magnetic Snap is reversed. If <strong>GridSnap</strong> is enabled and MagneticSnap does not find a postion, the first position will snap to the Grid. This is suppressed if <strong>Alt</strong> is held. +</p> +<p> +The <strong>Width</strong> field is a scaled dimension in inches if >0. If 0 it is a 1 pixel wide line at all zooms. If the value is negative, it is a scale-independent number of pixels wide. +</p> +<p> +If <em>Sticky</em> is set for straight draw, after the line is drawn there will be two text fields on the bottom rail, to allow fine-tuning of the angle and the length. Pressing <code>Enter</code> or <code>Tab</code> with the cursor in these boxes will apply the value to the line. Pressing <code>Space</code> or <code>Enter</code> on the drawing surface will move to drawing a new line. Pressing <code>Shift+Tab</code> will remove the current object and allow a new one to drawn. Even if <code>Esc</code> is pressed, the line will already exist, it can be removed with <strong>Undo</strong>. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Draw Dimension Line</title> +<link rel="previous" href="cmdDrawLine.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdDrawBench.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdDrawDimLine"></a>2.3.7.2 <a name="i0"></a>Draw Dimension Line</h1> +<p> +<img src="png.d/ddimlin.png"> +</p> +<p> +Creates a <strong>Dimension Line</strong> of various sizes. +</p> +<p> +With <strong>MagneticSnap</strong> (<a href="cmdMagneticSnap.html#cmdMagneticSnap">Section 2.12.1</a>) enabled, the new line start position will snap to the nearest draw object, as shown by the anchor unless <code>Alt</code> is held down. If it is disabled, it will only snap if <em>Alt</em> is held. If <strong>GridSnap</strong> is enabled and MagneticSnap does not find a postion, the first position will snap to the Grid. This is suppressed if <strong>Alt</strong> is held. +</p> +<p> +If <code>Ctrl</code> is held down during <code>Left+Drag</code> the line will snap the angle of the new side to a multiple of 90 degrees. +</p> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Draw Benchwork</title> +<link rel="previous" href="cmdDrawDimLine.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdDrawTableEdge.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdDrawBench"></a>2.3.7.3 <a name="i0"></a>Draw Benchwork</h1> +<p> +<img src="png.d/dbench.png"> +</p> +<p> +Creates <a name="i1"></a>Bench-work using different types and orientation of lumber. +</p> +<p> +<a name="i2"></a>Bench-work Notes +</p> +<dl><dd> +Lumber is drawn using the Dressed size which is 0.25" smaller than the indicated size: a 1" x 2" actually measures 0.75" x 1.75". The drawn height of <em>Girders</em> is 0.5" smaller. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<em>Girders</em> can be drawn in a variety of orientations: normal, inverted or rotated. <em>L-Girders</em> can be drawn with the flange to the Left or Right. +</dd> +</dl> +<p> + +</p> +<dl><dd> +When using metric units (<a href="cmdPref.html#cmdPref">Section 2.10.7</a>), a 1" x 2" is labeled 50mm x 25mm +</dd> +</dl> +<p> +With <strong>MagneticSnap</strong> (<a href="cmdMagneticSnap.html#cmdMagneticSnap">Section 2.12.1</a>) enabled, the new line start position will snap to the nearest draw object, as shown by the anchor unless <code>Alt</code> is held down. If it is disabled, it will only snap if <em>Alt</em> is held. If <strong>GridSnap</strong> is enabled and MagneticSnap does not find a postion, the first position will snap to the Grid. This is suppressed if <strong>Alt</strong> is held. +</p> +<p> +If <code>Ctrl</code> is held down during <code>Left+Drag</code> the line will snap the angle of the new side to a multiple of 90 degrees. +</p> +<p> +If <em>Sticky</em> is set for straight draw, after the benchwork is drawn there will be two text fields on the bottom rail, to allow fine-tuning of the angle and the length. Pressing <code>Enter</code> or <code>Tab</code> with the cursor in these boxes will apply the value to the benchwork. Pressing <code>Space</code> or <code>Enter</code> or <code>Tab</code> on the drawing surface will move to drawing a new benchwork line. Pressing <code>Shift+Tab</code> on the drawing surface will remove the current object and allow a new one to be drawn. Even if <code>Esc</code> is pressed, the benchwork will already exist, it can be removed with <strong>Undo</strong>. +</p> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Draw Table Edge</title> +<link rel="previous" href="cmdDrawBench.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="DrawOrigin.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdDrawTableEdge"></a>2.3.7.4 <a name="i0"></a>Draw Table Edge</h1> +<p> +<img src="png.d/dtbledge.png"> +</p> +<p> +Creates a <strong>Table Edge</strong> +</p> +<p> +With <strong>MagneticSnap</strong> (<a href="cmdMagneticSnap.html#cmdMagneticSnap">Section 2.12.1</a>) enabled, the new line start position will snap to the nearest draw object, as shown by the anchor unless <code>Alt</code> is held down. If it is disabled, it will only snap if <em>Alt</em> is held. If <strong>GridSnap</strong> is enabled and MagneticSnap does not find a postion, the first position will snap to the Grid. This is suppressed if <strong>Alt</strong> is held. +</p> +<p> +If <code>Ctrl</code> is held down during <code>Left+Drag</code> the edge will to a end point of another table edge or to a multiple of 90 degrees if that isn't available. +</p> +<p> +If <em>Sticky</em> is set for straight draw, after the edge is drawn there will be two text fields on the bottom rail, to allow fine-tuning of the angle and the length. Pressing <code>Enter</code> or <code>Tab</code> with the cursor in these boxes will apply the value to the edge. Pressing <code>Space</code> or <code>Enter</code> or <code>Tab</code> on the drawing surface will move to drawing a new edge. Pressing <code>Shift+Tab</code> on the drawing surface will remove the current object and allow a new one to be drawn. Even if <code>Esc</code> is pressed, the edge will already exist, it can be removed with <strong>Undo</strong>. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Draw Objects Origin</title> +<link rel="previous" href="cmdDrawTableEdge.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdText.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="DrawOrigin"></a>2.3.8 <a name="i0"></a>Draw Objects Origin</h1> +<p> +Some objects will a natural rotation point within them. By setting the object origin to this point, subsequent rotation will be about that point and not the layout origin. This is referred to as a <em>Relative</em> origin and will be present if the origin is non-zero. When an object with a Relative is moved or rotated, the origin and angle are adjusted but the relative draw point values remain the same. If an object has a zero origin, it is called Absolute. If it is moved or rotated, the origin and angle remain zero, but all the obect point(s) are adjusted. +</p> +<p> +You can choose to set the origin to make it Relative or put it back to Absolute (origin zero) during <a href="cmdDrawShapes.html#cmdDrawShapes">Section 2.3.6</a> or <a href="cmdModify.html#cmdModify">Section 2.2.8</a> or by using the <a href="cmdDescribe.html#cmdDescribe">Section 2.2.13</a> settings. +</p> +<p> +As a practical matter, the object will appear identical until a subsequent rotation value is entered in the <a href="cmdDescribe.html#cmdDescribe">Section 2.2.13</a> window in both cases. +</p> +<p> +In Origin Mode (entered using <code>'o'</code> or the Context Menu, there are certain shortcuts available - +</p> +<dl><dd> +<code>'p'</code> Go to Points Mode +</dd> +<dd> +<code>'0'</code> Move to Absolute (Origin to 0,0) +</dd> +<dd> +<code>'1-4'</code> Move the Relative Origin to the shape point 1 to 4 +</dd> +<dd> +<code>'l'</code> Move the Relative Origin to the last selected point +</dd> +<dd> +<code>'m'</code> Move the Relative Origin to the middle of the shape (centeroid). +</dd> +</dl> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Text</title> +<link rel="previous" href="DrawOrigin.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="editM.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdText"></a>2.3.9 <a name="i0"></a>Text</h1> +<p> +<img src="png.d/btext.png"> +</p> +<p> +The <strong>Text</strong> command lets you enter a Text Draw object on the layout at the selected position. You can use the Tab key to format the text to fixed tab positions and CTRL+Enter to enter a newLine character. +</p> +<p> +<img src="png.d/statustext.png"> +</p> +<p> +The font size can be changed by the Font Size drop list on the <strong>Status-bar</strong> (<a href="mainW.html#mainW">Section 3.1</a>). The font size is scaled along with everything else on the layout so text is always the same relative size as other layout objects. +</p> +<p> +The color used can be selected by the Color icon on the <strong>Status-bar</strong> (<a href="mainW.html#mainW">Section 3.1</a>). +</p> +<p> +The new text object can be "boxed" by having a line drawn around it using the Boxed tick-mark on the <strong>Status-bar</strong> (<a href="mainW.html#mainW">Section 3.1</a>). +</p> +<p> +The position where text is to be placed on the layout is selected prior to text entry by <code>Left-Click</code>ing on the layout at the point where the text is to appear. Desired text is input after the position is selected. If necessary, the location can be changed once text entry begins by <code>Left-Click+Drag</code>ing the text to any desired postion on the layout. +</p> +<p> +The <strong>Properties</strong> (<a href="cmdDescribe.html#cmdDescribe">Section 2.2.13</a>) command can be used to modify the contents, color and fontsize of existing <strong>Text</strong> objects and to set the boxes property. +</p> +<p> +The new Text object is committed when another command is entered (or <em>Enter</em> is used if the Text command is Sticky). +</p> +<p> +The font used for all Text objects can be selected by the <strong>Font Selection</strong> (<a href="fontSelW.html#fontSelW">Section 2.10.5</a>) dialog invoked by the <strong>Options>Fonts</strong> menu item or by <code>Shift+Right-Click</code> (<a href="cmdAcclKeys.html#cmdAcclKeys">Section 3.4</a>). +</p> +<p> +Note: loading fonts (or changing sizes) can take a noticeable amount of time. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Edit Menu</title> +<link rel="previous" href="cmdText.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdSelectIndex.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="editM"></a>2.4 <a name="i0"></a>Edit Menu</h1> +<p> +<img src="png.d/medit.png"> +</p> +<p> +The <strong>Edit Menu</strong> shows commands affecting the <strong>Main Canvas</strong> (<a href="mainW.html#mainW">Section 3.1</a>). +</p> +<dl><dd> +<a name="i1"></a>Undo - Reverses the last command. Up to the last ten commands can be undone. If there are no commands that can be undone the <strong>Undo</strong> item is disabled. The <strong>Undo</strong> command can also be invoked by the <strong>Undo</strong> button (<a href="cmdUndo.html#cmdUndo">Section 2.4.9</a>). +</dd> +</dl> +<p> + +</p> +<dl><dd> +<a name="i2"></a>Redo - Undoes the last Undo command. The <strong>Redo</strong> command can also be invoked by the <strong>Redo</strong> button (<a href="cmdUndo.html#cmdUndo">Section 2.4.9</a>). +</dd> +</dl> +<p> + +</p> +<dl><dd> +<a name="i3"></a>Cut - Moves the selected objects to the clipboard. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<a name="i4"></a>Copy - Copies the selected objects to the clipboard. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<a name="i5"></a>Paste - Copies the contents of the clipboard to the layout. Using the paste Menu command it will be placed at the center of the screen. If the context menu paste is used or the short-cuts <em>Ctrl+v</em> or <em>Shift+Insert</em>, the parts will be placed at the cursor position. Repeated Pastes without moving the cursor result in overlaid copies. The newly pasted parts are in <strong>Selected</strong> state and can easily be moved into place. Any previously selected objects are unselected. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<a name="i6"></a>Delete - Deletes the selected objects. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<a name="i7"></a>Move To Current Layer - move all selected objects to the current Layer (<a href="cmdLayer.html#cmdLayer">Section 2.9.5</a>). +</dd> +</dl> +<p> + +</p> +<dl><dd> +<a name="i8"></a>Select All - Selects all objects on the layout. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<a name="i9"></a>Select Current Layer - selects all objects in the current Layer (<a href="cmdLayer.html#cmdLayer">Section 2.9.5</a>). +</dd> +</dl> +<p> + +</p> +<dl><dd> +<a name="i10"></a>Select By Index - selects object by index number (<a href="cmdSelectIndex.html#cmdSelectIndex">Section 2.4.1</a>). +</dd> +</dl> +<p> + +</p> +<dl><dd> +<a name="i11"></a>Deselect All - unselects all objects on the layout. The same action can be achieved by pressing the ESC key. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<a name="i12"></a>Invert Selection - selects all unselected objects and unselects all previously selected objects. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<a name="i13"></a>Select Stranded Track - selects all track pieces that are not connected to any other objects. This helps cleaning up a drawing after many changes have been made. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<a name="i14"></a>Tunnel<a name="i15"></a> - Hides or reveals selected tracks and adds a tunnel portal symbol where the track passes from one to the other. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<a name="i16"></a>Bridge<a name="i17"></a> - Adds or removes parapet symbols and a solid base to the track. The color is selectable (<a href="cmdRgbcolor.html#cmdRgbcolor">Section 2.10.1</a>). +</dd> +</dl> +<p> + +</p> +<dl><dd> +<a name="i18"></a>Roadbed<a name="i19"></a> - Adds or removes solid roadbed under the track. The color is selectable (<a href="cmdRgbcolor.html#cmdRgbcolor">Section 2.10.1</a>). +</dd> +</dl> +<p> + +</p> +<dl><dd> +<a name="i20"></a>Ties/No Ties<a name="i21"></a><a name="i22"></a> - Hides or reveals the ties on selected tracks. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<a name="i23"></a>Move To Front - Moves selected object to foreground. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<a name="i24"></a>Move To Back - Moves selected object to background. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<a name="i25"></a>Thin, Medium and Thick Tracks <a name="i26"></a><a name="i27"></a> <a name="i28"></a><a name="i29"></a><a name="i30"></a><a name="i31"></a> <a name="i32"></a> - set displayed rail width of selected tracks. +</dd> +</dl> +<p> + +</p> +<p> +For more information on working with selected objects, see the Select (<a href="cmdSelect.html#cmdSelect">Section 2.2.16</a>) command. +</p> +<hr> +<ul> +<li><a href="cmdSelectIndex.html#cmdSelectIndex">2.4.1 Select By Index</a></li> +<li><a href="cmdAboveBelow.html#cmdAboveBelow">2.4.2 "Move To Front" and "Move to Back" </a></li> +<li><a href="addshortcutkeys.html#addshortcutkeys">2.4.3 Additional Shortcut Keys</a></li> +<li><a href="cmdDelete.html#cmdDelete">2.4.4 Delete</a></li> +<li><a href="cmdTunnel.html#cmdTunnel">2.4.5 Tunnel (Hide Tracks)</a></li> +<li><a href="cmdTies.html#cmdTies">2.4.6 Ties (Draw or Hide Ties)</a></li> +<li><a href="cmdBridge.html#cmdBridge">2.4.7 Bridge (Draw or Hide Abutments)</a></li> +<li><a href="cmdRoadbed.html#cmdRoadbed">2.4.8 Roadbed (Draw or Hide Base)</a></li> +<li><a href="cmdUndo.html#cmdUndo">2.4.9 Undo and Redo </a></li> +</ul> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Select By Index</title> +<link rel="previous" href="editM.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdAboveBelow.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdSelectIndex"></a>2.4.1 <a name="i0"></a>Select By Index</h1> +<p> +An input window allows one or more index numbers to be entered. Multiple indexes are seperated by commas. +</p> +<p> +The object can not be selected if its Layer is frozen. +</p> +<p> +If the object is part of a module layer, all objects in the layer will be selected. +</p> +<p> +If the object is a tunnel object, and the Display Tunnel option is None, it will be set to Dashed. See Display options (<a href="cmdDisplay.html#cmdDisplay">Section 2.10.3</a>). +</p> +<p> +When an individual object is selected, its index number is displayed in the Info Message area, another source is the List Parts (<a href="cmdEnum.html#cmdEnum">Section 2.9.6</a>) command with the <strong>List Indexes</strong> option. +</p> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>"Move To Front" and "Move to Back" </title> +<link rel="previous" href="cmdSelectIndex.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="addshortcutkeys.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdAboveBelow"></a>2.4.2 "Move To Front" and "Move to Back" <a name="i0"></a> <a name="i1"></a></h1> +<p> +<img src="png.d/btop_bottom.png"> +</p> +<p> +The Move to Front and Move To Back commands move the selected objects (<a href="cmdSelect.html#cmdSelect">Section 2.2.16</a>) to the top of the drawing list - the <strong>Foreground</strong> or to the bottom of the list - the <strong>Background</strong> making them more or less visible or prominent. +</p> +<p> +The effect is to make the objects move to be in front of all or behind all other objects. This command is useful when dealing with filled shapes (<a href="cmdDraw.html#cmdDraw">Section 2.3</a>). +</p> +<p> +Selected objects moved to the <strong>Background</strong> become unselected. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Additional Shortcut Keys</title> +<link rel="previous" href="cmdAboveBelow.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdDelete.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="addshortcutkeys"></a>2.4.3 <a name="i0"></a>Additional Shortcut Keys</h1> +<p> +Additional Shortcut keys perform the following: +</p> +<dl><dd> +<code>Ctrl+Z</code> - Undo +</dd> +</dl> +<p> + +</p> +<dl><dd> +<code>Ctrl+R</code> - Redo +</dd> +</dl> +<p> + +</p> +<dl><dd> +<code>Ctrl+C</code> - Copy +</dd> +</dl> +<p> + +</p> +<dl><dd> +<code>Ctrl+V</code> - Paste +</dd> +</dl> +<p> + +</p> +<dl><dd> +<code>Ctrl+X</code> - Cut +</dd> +</dl> +<p> + +</p> +<dl><dd> +<code>Esc</code> - Deselect All +</dd> +</dl> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Delete</title> +<link rel="previous" href="addshortcutkeys.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdTunnel.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdDelete"></a>2.4.4 <a name="i0"></a>Delete</h1> +<p> +<img src="png.d/bdelete.png"> +</p> +<p> +The <strong>Delete</strong> button is used to delete selected objects. Remember, the <strong>Undo</strong> (<a href="editM.html#editM">Section 2.4</a> or <a href="cmdUndo.html#cmdUndo">Section 2.4.9</a>) command can be used to restore a delete object. +</p> +<p> +Deleting a track that is connected to an easement (<a href="cmdEasement.html#cmdEasement">Section 2.10.4</a>) causes the easement to be deleted as well. +</p> +<p> +The <em>Delete</em> key invokes the Delete command. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Tunnel (Hide Tracks)</title> +<link rel="previous" href="cmdDelete.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdTies.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdTunnel"></a>2.4.5 <a name="i0"></a>Tunnel (Hide Tracks)</h1> +<p> +<img src="png.d/btunnel.png"> +</p> +<p> +The <strong>Tunnel</strong> command is used to hide selected (<a href="cmdSelect.html#cmdSelect">Section 2.2.16</a>) tracks (as in a tunnel). +</p> +<p> +Select the tracks you want to hide in a tunnel. Selecting a hidden track 'reveals' it. +</p> +<p> +A tunnel portal is drawn where a hidden track connects with an 'unhidden' track. You can split (<a href="cmdSplitTrack.html#cmdSplitTrack">Section 2.2.17.1</a>) a track to place a tunnel portal at a particular spot. +</p> +<p> +The <strong>Draw Tunnels</strong> Radio button group on the <strong>Options>Display</strong> dialog (<a href="cmdDisplay.html#cmdDisplay">Section 2.10.3</a>) controls whether hidden tracks are not drawn, drawn as dashed lines or drawn as normal lines. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Ties (Draw or Hide Ties)</title> +<link rel="previous" href="cmdTunnel.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdBridge.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdTies"></a>2.4.6 <a name="i0"></a>Ties (Draw or Hide Ties)</h1> +<p> +<img src="png.d/bties.png"> +</p> +<p> +The <strong>Ties</strong> command is used to hide Ties (or reshow them). This may be useful for overlapping track, like dual gauge, or in areas like docks or yards where the track is covered. +</p> +<p> +Select the tracks you want to hide or show ties for. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Bridge (Draw or Hide Abutments)</title> +<link rel="previous" href="cmdTies.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdRoadbed.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdBridge"></a>2.4.7 <a name="i0"></a>Bridge (Draw or Hide Abutments)</h1> +<p> +<img src="png.d/bbridge.png"> +</p> +<p> +The <strong>Bridge</strong> command is used to add abutments to a track (as on an underbridge). +</p> +<p> +Select the tracks you want to be a bridge. Bridge abutments are drawn alongside the track and a solid layer is added under the ties. You can split (<a href="cmdSplitTrack.html#cmdSplitTrack">Section 2.2.17.1</a>) a track to shorten the length of the bridge, or to add an extra pier to the drawing. +</p> +<p> +If you perform this action on an existing bridge (or use Tunnel) the bridge is removed. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Roadbed (Draw or Hide Base)</title> +<link rel="previous" href="cmdBridge.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdUndo.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdRoadbed"></a>2.4.8 <a name="i0"></a>Roadbed (Draw or Hide Base)</h1> +<p> +<img src="png.d/broadbed.png"> +</p> +<p> +The <strong>Roadbed</strong> command is used to add a solid color under a track (as roadbed). +</p> +<p> +Select the tracks you want to have roadbed. A solid roadbed layer is drawn under the track. +</p> +<p> +If you perform this action on existing roadbed (or use Tunnel) the roadbed is removed. The bridge option takes precedence over roadbed. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Undo and Redo </title> +<link rel="previous" href="cmdRoadbed.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="fileM.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdUndo"></a>2.4.9 Undo and Redo <a name="i0"></a> <a name="i1"></a></h1> +<p> +<img src="png.d/bgundo.png"> +</p> +<p> +The <strong>Undo</strong> and <strong>Redo</strong> buttons invoke the same actions as the <strong>Edit</strong> menu items. The name of last command will be displayed as the Balloon Help (<a href="windowTerms.html#windowTerms">Section B.1</a>) for the <em>Undo</em> button. The name of last undone command will be displayed as the Balloon Help for the <em>Redo</em> button. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>File Menu</title> +<link rel="previous" href="cmdUndo.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdExport.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="fileM"></a>2.5 <a name="i0"></a>File Menu</h1> +<p> +<img src="png.d/mfile.png"> +</p> +<p> +The <strong>File Menu</strong> shows file oriented commands for loading and saving layout files. <a name="i1"></a>File Types The main two filetypes that XTrackCAD uses are normal Layout Files (*.xtc) and Archive Files (*.xtce). The internals of both formats are described in the XtrkCAD Wiki at <a href="http://www.xtrkcad.org/Wikka/FileFormats" target="_blank">Wiki FileFormats</a>. +</p> +<p> +<a name="i2"></a>Layout File The layout file is named with a <em>*.xtc</em> extenstion and is a text-based description file of all the objects used in the layout plus some information about the options currently in use. <a name="i3"></a>Archive An archive is named with a <em>*.xtce</em> extension, is a zipped collection of - +</p> +<ul><li> +a <em>manifest</em> JSON file that lists the contents, +</li> +<li> +the .xtc layout file, and +</li> +<li> +any other content listed in the manifest -> such as referenced image files. Initially the only such content is the background image which is added to the archive if it is present. +</li> +</ul> +<dl><dd> +<strong>Exit</strong> - Exits <em>XTrackCAD</em>. You will be asked to confirm your choice if there are unsaved changes. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<img src="png.d/bexport.png"> <strong>Export</strong> - Exports objects to a file in <em>XTrackCAD</em> (*.xti) format. If no objects are selected, all objects in visible layers are exported. If objects are selected they are exported. The exported file can then be imported into another layout design. Refer to the Import command listed below. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<img src="png.d/bexportbmap.png"><strong>Export to Bitmap</strong> - Creates a bitmap file (<a href="cmdOutputbitmap.html#cmdOutputbitmap">Section 2.5.2</a>) of the layout. The bitmap can be saved in either JPEG or PNG format. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<img src="png.d/bexportdxf.png"><strong>Export to DXF</strong> - Exports objects to a file in DXF format (<a href="generalTerms.html#generalTerms">Section B.2</a>). If no objects are selected, all objects in visible layers are exported. If objects are selected they are exported. The exported file can then be imported into other CAD programs. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<img src="png.d/bexportsvg.png"> <strong>Export to SVG</strong> - Exports objects to a file in SVG format. If no objects are selected, all objects in visible layers are exported. If objects are selected they are exported. The exported file can then be imported into a vector drawing program like Inkscape or used for publishing on the web. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>File List</strong> - List of the five most recently used <em>XTrackCAD</em> files or archives. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<img src="png.d/bimport.png"> <strong>Import</strong> - Displays the file selection dialog which allows selection of an existing <em>XTrackCAD</em> Import (<a href="cmdExport.html#cmdExport">Section 2.5.1</a> *.xti) files. This function can be used to transfer parts like a yard design from one layout design to another. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<img src="png.d/bimportmod.png"> <strong>Import Module</strong> - Displays the file selection dialog which allows selection of an existing <em>XTrackCAD</em> Import (<a href="cmdExport.html#cmdExport">Section 2.5.1</a> *.xti) file. The imported parts are put into a empty layer, sets the layer name to the imported filename and sets the layer to be a module - see (<a href="cmdLayer.html#cmdLayer">Section 2.9.5</a>). +</dd> +<dd> +<img src="png.d/bnew.png"> <strong>New</strong> - Clears the current layout. In case there are any unsaved changes on the current plan, a warning pop-up will be displayed and you'll have the option to cancel the operation. After that the Layout Options (<a href="cmdLayout.html#cmdLayout">Section 2.10.6</a>) dialog will be opened. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Notes</strong> - Displays a simple notepad editor which you can use to enter information about the layout. Typically this could include prototype, period, theme, layout style, height, construction, type of track and turnouts used, control system and anything else of interest. (There is also a <strong>Note</strong> command (<a href="cmdNote.html#cmdNote">Section 2.3.3</a>) which allows attaching notes to particular parts of the layout.) +</dd> +</dl> +<p> + +</p> +<dl><dd> +<img src="png.d/bopen.png"> <strong>Open</strong> - Displays the <strong>File Open</strong> dialog which allows an existing <em>XTrackCAD</em> file or archive to be selected and opened. In case there are any unsaved changes on the current plan, a warning pop-up will be displayed and you'll have the option to cancel the operation. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<img src="png.d/bparam.png"> <strong>Parameter Files</strong> - Displays the <strong>Parameter Files</strong> dialog (<a href="cmdPrmfile.html#cmdPrmfile">Section 2.5.7</a>) to choose parameter files. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<img src="png.d/bsetup.png"> <strong>Print Setup</strong> - Shows the Printer Setup Dialog (<a href="printSetup.html#printSetup">Section 2.5.10</a>). +</dd> +</dl> +<p> + +</p> +<dl><dd> +<img src="png.d/bprint.png"> <strong>Print</strong> - Invokes the Print command (<a href="cmdPrint.html#cmdPrint">Section 2.5.9</a>). +</dd> +</dl> +<p> + +</p> +<dl><dd> +<img src="png.d/brevert.png"> <strong>Revert</strong> - Undoes all changes and returns to the last saved layout plan. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<img src="png.d/bsave.png"> <strong>Save</strong> - Saves the layout under the current file name and with the same file type as was opened. If a filename has not yet been assigned then the <strong>File Save</strong> dialog is shown so you enter a file (.xtc) or archive name (.xtce). +</dd> +</dl> +<p> + +</p> +<dl><dd> +<img src="png.d/bsaveas.png"> <strong>Save As</strong> - This command lets you make a copy of the track plan you are currently working on as an file (.xtc) or an archive (.xtce). It differs from the regular Save command. Save stores your data back into the folder (directory) it originally came from in the same filetype. "Save As" lets you give your plan a different name and/or put it in a different folder on your hard disk and chnage its filetype using the selection box at the bottom of the list of files or by hardcoding the extensions .xtc or .xtce (for an archive). +</dd> +</dl> +<hr> +<ul> +<li><a href="cmdExport.html#cmdExport">2.5.1 Export</a></li> +<li><a href="cmdOutputbitmap.html#cmdOutputbitmap">2.5.2 Export to Bitmap</a></li> +<li><a href="ExportDXF.html#ExportDXF">2.5.3 Export to DXF</a></li> +<li><a href="ExportSVG.html#ExportSVG">2.5.4 Export to SVG</a></li> +<li><a href="cmdImport.html#cmdImport">2.5.5 Import</a></li> +<li><a href="cmdImportM.html#cmdImportM">2.5.6 Import as Module</a></li> +<li><a href="cmdPrmfile.html#cmdPrmfile">2.5.7 Parameter Files</a></li> +<li><a href="cmdSearchgui.html#cmdSearchgui">2.5.8 Choose Parameter Files</a></li> +<li><a href="cmdPrint.html#cmdPrint">2.5.9 Printing</a></li> +<li><a href="printSetup.html#printSetup">2.5.10 Printer Setup</a></li> +<ul> +<li><a href="Linux.html#Linux">2.5.10.1 Linux</a></li> +<li><a href="MS-Windows.html#MS-Windows">2.5.10.2 Microsoft Windows</a></li> +</ul> +<li><a href="cmdPrintMargin.html#cmdPrintMargin">2.5.11 Printer Margin</a></li> +</ul> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Export</title> +<link rel="previous" href="fileM.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdOutputbitmap.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdExport"></a>2.5.1 <a name="i0"></a>Export</h1> +<p> +<img src="png.d/bexport.png"> +</p> +<p> +This menu item displays a file selection dialog where a file name for exported objects can be entered. All selected (<a href="cmdSelect.html#cmdSelect">Section 2.2.16</a>) objects are exported to the file. The export file will have an <code>xti</code> extension. +</p> +<p> +<img src="png.d/exportfile.png"> +</p> +<p> +Using the Import command (<a href="cmdImport.html#cmdImport">section 2.5.5</a>), an exported file can be imported into another layout design. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Export to Bitmap</title> +<link rel="previous" href="cmdExport.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="ExportDXF.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdOutputbitmap"></a>2.5.2 <a name="i0"></a>Export to Bitmap</h1> +<p> +<img src="png.d/bexportbmap.png"> +</p> +<p> +This menu item creates a bitmap file of the layout. +</p> +<p> +<img src="png.d/bitmap.png"> +</p> +<p> +The <strong>Bitmap</strong> dialog specifies the style and size of the bitmap. The check-boxes (<strong>Layout Titles</strong>, <strong>Borders</strong>, <strong>Centerline of Track</strong> and <strong>Background Image</strong>) control whether the Layout Title (<a href="cmdLayout.html#cmdLayout">Section 2.10.6</a>), the borders or the track centerlines are printed on the bitmap. If a background image is used it will be printed if the option is set. +</p> +<p> +The size of the bitmap is smaller if these are disabled. +</p> +<p> +Printing the track centerlines (also seen when zoomed in 1:1) is useful when you later print the bitmap full size for laying out track. +</p> +<p> +If the Snap Grid (<a href="cmdGrid.html#cmdGrid">Section 2.12.2</a>) is visible then it will be printed on the bitmap. +</p> +<p> +The <strong>DPI</strong> control specifies the number of pixels per inch in the bitmap. Bitmaps must be less than 32,000 pixels in height or width. The upper value you can enter depends on the size of your trackplan. It is made sure that your bitmap does not exceed these limits. Larger values will result in a larger bitmap file. +</p> +<p> +The bitmap width, height and approximate file size is indicated. +</p> +<p> +Note: This command can create a very large file and consume a lot of memory and time. +</p> +<p> +Pressing the <strong>OK</strong> button invokes a <strong>File Save</strong> dialog so you can choose the file name for the Bitmap. +</p> +<p> +You can select to create JPEG or PNG files. As a rule of thumb JPEG results in smaller files when you use a backgound image, PNG does so for trackplans without an image background. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Export to DXF</title> +<link rel="previous" href="cmdOutputbitmap.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="ExportSVG.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="ExportDXF"></a>2.5.3 <a name="i0"></a>Export to DXF</h1> +<p> +<img src="png.d/bexportdxf.png"> +</p> +<p> +This menu item displays a file selection dialog where a file name for exported objects can be entered. All selected (<a href="cmdSelect.html#cmdSelect">Section 2.2.16</a>) objects are exported to the file. The export file will have an <code>xti</code> extension. +</p> +<p> +<img src="png.d/exportfiledxf.png"> +</p> +<p> +Exported files can then be imported into other CAD programs. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Export to SVG</title> +<link rel="previous" href="ExportDXF.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdImport.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="ExportSVG"></a>2.5.4 <a name="i0"></a>Export to SVG</h1> +<p> +<img src="png.d/bexportsvg.png"> +</p> +<p> +This menu item displays a file selection dialog where a file name for exported objects can be entered. All selected (<a href="cmdSelect.html#cmdSelect">Section 2.2.16</a>) objects are exported to the file. The export file will have an <code>svg</code> extension. +</p> +<p> +<img src="png.d/exportfilesvg.png"> +</p> +<p> +Files in SVG format can be used for different purposes. +</p> +<ul><li> +SVG files can be loaded into many drawing programs. This makes it possible to enhance and resize the image. Vector images have the advantage of allowing lossless resizing. +</li> +<li> +Most modern browsers support SVG as an image format. So the resulting file can directly be used to publish your plan on the web. By adding a bit of Javascript, zooming and panning can be enabled. Appropiate scripts can easily be found using your favorite search engine. The generated SVG uses the layout description as a title that is shown by some browser. Also the drawing has an 'id' for manipulation by Javascript. This id is derived from the filename by removing all spaces and sticking the word 'id' in front. Eg exporting <code>stonega.xtc</code> the resulting id will be <code>idstonega</code>. +</li> +</ul> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Import</title> +<link rel="previous" href="ExportSVG.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdImportM.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdImport"></a>2.5.5 <a name="i0"></a>Import</h1> +<p> +<img src="png.d/bimport.png"> +</p> +<p> +Importing displays a file selection dialog to specify the file to import. +</p> +<p> +<img src="png.d/import.png"> +</p> +<p> +After importing the objects from the file, the imported objects are in selected state and therefore are drawn in red. This allows you to easily move and rotate the imported objects to their final position. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Import as Module</title> +<link rel="previous" href="cmdImport.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdPrmfile.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdImportM"></a>2.5.6 <a name="i0"></a>Import as Module</h1> +<p> +<img src="png.d/bimportxtc.png"> +</p> +<p> +Importing displays a file selection dialog to specify the file to import as a module. +</p> +<p> +<img src="png.d/importmod.png"> +</p> +<p> +After importing the objects from the file, the imported objects are in selected state and therefore are drawn in red. This allows you to easily move and rotate the imported objects to their final position. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Parameter Files</title> +<link rel="previous" href="cmdImportM.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdSearchgui.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdPrmfile"></a>2.5.7 <a name="i0"></a>Parameter Files</h1> +<p> +<img src="png.d/bparam.png"> +</p> +<p> +<em>Parameter Files</em> contain turnout, sectional track and structure definitions. Loaded Parameter Files are managed with the <strong>Parameter Files</strong> dialog. +</p> +<p> +<img src="png.d/dprmfile.png"> +</p> +<p> +The dialog contains a list of parameter files. Each file is preceded by a color indicator. These indicators show whether a parameter file contains definitions that are usable in the current scale and gauge. +</p> +<p> +<img src="png.d/greendot.png"> <img src="png.d/greenstar.png"> Definitions from this file are a perfect fit for the current layout options. The file has been loaded and will be visible in the <strong>HotBar</strong>. For track this means that gauge and scale of the track elements are identical to the layout settings. Prototype definitions (Scale "*") are always a perfect fit. Turnouts and Sectional Track must have the same gauge and usually the same scale unless the scale/gauge combination has been defined to fit. OO layouts use HO track as an example. +</p> +<p> +<img src="png.d/yellowdot.png"> <img src="png.d/yellowstar.png"> Definitions from this file can be used with this layout but do not fit perfectly. A typical example is On30 where HO scale track can be used because the gauge is the same. But differences in scale may make the track look out of scale. Structures are considered compatible if the scale is within +/-20%. Cars are compatible if the gauge is the same, but the scale can be +/-20%. Exceptions to this can be defined in the scale definitions. +</p> +<p> +<img src="png.d/reddot.png"> <img src="png.d/redstar.png"> This parameter file doesn't contain any usable definitions with current settings. You may want to change the layout options if you want to use elements from this file (for example altering the Layout Scale). +</p> +<p> +<img src="png.d/greydot.png"> <img src="png.d/greystar.png"> This file is loaded but hidden. If it is marked as favorite it will be kept on the list between runs. +</p> +<p> +Parameter files can be marked as <em>favorite</em>. The indicator for favorites is a star. The meaning of the colors isn't changed. +</p> +<p> +Loaded definition files that are marked with a yellow or a green indicator appear on the <strong>Hot Bar</strong> (<a href="cmdHotBar.html#cmdHotBar">Section 2.7</a>). +</p> +<p> +If you <em>unload</em> a file the definitions are removed from the selection lists and the <strong>Hot Bar</strong>. If the unloaded file was marked as a favorite it can be <em>reloaded</em> by selecting the <strong>Reload</strong> button. +</p> +<p> +Files that are still loaded can be <em>reloaded</em> as well. In that case the old definitions are refreshed and extended by the rereading the file. This can be useful if you want to check changes you made by hand-editing a parameter file. +</p> +<p> +Note that loading a file does not change the existing definitions in the layout. To do that after loading, use <a href="cmdRefreshSpecial.html#cmdRefreshSpecial">Section 2.9.10</a>. +</p> +<p> +It is possible to change the state of several files at once. The <strong>Select All</strong> button allows you to select all parameter files for the next operation. +</p> +<p> +In case unloaded files are marked as favorite, their state will be preserved between runs of the program. This makes it possible to keep a list of preferred parameter sets between runs of XTrackCAD but hide temporary unused files from the hotbar. That way the hotbar contents can be kept short containing only the currently needed elements. +</p> +<p> +In order to update the defintion of an already loaded file from disk, you can use the <em>Reload</em> button. This will reload the file contents - with any changes made. It is the equivalent of using <strong>Browse</strong> and selecting the file again. +</p> +<p> +Files can be listed by either their file name or by their contents description. This is controlled by the <strong>Show File Names</strong> check box. +</p> +<p> +The <strong>Library</strong> button opens the <em>Choose Parameter File</em> dialog (<a href="cmdSearchgui.html#cmdSearchgui">Section 2.5.8</a>) this shows the all files included the system library so they can be added. +</p> +<p> +The <strong>Browse</strong> button opens a file window that allows the user to add additional files to directly load other non-system <em>parameter files</em> such as provided by other users or downloaded from the Internet. +</p> +<p> +When first installed, parameter files for all common scales are loaded. You can unload parameter files you don't use to speed up <em>XTrackCAD</em> startup time. +</p> +<p> +The order in this list controls the order of turnouts and structures on the <strong>Hot Bar</strong> (<a href="cmdHotBar.html#cmdHotBar">Section 2.7</a>). You can move a parameter file to the end of the list by <em>Unloading</em> it, and then loading it via the <strong>Browse</strong> button. +</p> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Choose Parameter Files</title> +<link rel="previous" href="cmdPrmfile.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdPrint.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdSearchgui"></a>2.5.8 <a name="i0"></a>Choose Parameter Files</h1> +<p> +Selecting and loading additional parameter files from the System Library is done in the <strong>Choose Parameter Files</strong> dialog. +</p> +<p> +<img src="png.d/paramsearch.png"> +</p> +<p> +Using the Search function you can find and select parameter files that are part of the XTrackCAD installation. Enter a set of one or more words and select the Search button. Search results are shown in the list box. Pressing the <a name="i1"></a>Clear Filter button shows the complete list again. +</p> +<p> +You can subset the search to only search for parameter files who start with contents that fit the current Layout Scale using the <strong>Fit</strong> Mode. The options are "Fit All", "Fit Compatible" and "Fit Exact". Fit Compatible means that structures with Note that the code only looks at the first Turnout, Structure or Car entry to decide on the scale for the entire file. They will correspond to the color icons on the Parameter Files menu once they are loaded <a href="cmdPrmfile.html#cmdPrmfile">Section 2.5.7</a> when the same Layout scale is in use. +</p> +<p> +Select the files you're interested in and press the <strong>Add</strong> button to add them to your parameter list. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Printing</title> +<link rel="previous" href="cmdSearchgui.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="printSetup.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdPrint"></a>2.5.9 <a name="i0"></a>Printing</h1> +<p> +<img src="png.d/bprint.png"> +</p> +<p> +The <strong>Print</strong> command (<strong>File>Print</strong>) is used to print all or a portion of the layout. +</p> +<p> +<img src="png.d/bsetup.png"> +</p> +<p> +The <strong>Print Setup</strong> command (<strong>File>Print Setup</strong>) is used to set up the printer properties. +</p> +<p> +When the <strong>Print</strong> command is selected a grid, which represents each printed page, is drawn on the layout. Pages can be selected or unselected for printing by placing the mouse over a grid section and clicking the left mouse button. +</p> +<p> +<img src="png.d/print.png"> +</p> +<p> +The <strong>Print</strong> dialog contains a number of control areas: +</p> +<dl><dt> +The size of each page is controlled by: +</dt> +<dd> +<strong>Scale</strong> - up to 1:1. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Width, Height</strong> - scaled size of each page. Values for <strong>Width</strong> and <strong>Height</strong> can be manually entered, overriding the maximum values. Values larger than the page size times the <em>Scale</em> cannot be entered. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Max</strong> - sets Width and Height to the maximum for the print <em>Scale</em>. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Snap Shot</strong> - adjusts the <em>Scale</em>, <em>Origin</em> and <em>Angle</em> to produce a one-page snap shot of the layout. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Format</strong> - Portrait or Landscape. +</dd> +</dl> +<p> + +</p> +<dl><dt> +Page printing order is controlled by the <strong>Print Order</strong> option. +</dt> +<dd> +Relative to the Print Grid: +<dl><dd> +<strong>Normal</strong> order is Columns first, Top to Bottom, Left to Right. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Reverse</strong> order is Rows first, Left to Right, Bottom to Top. +</dd> +</dl> + +</dd> +</dl> +<p> +Whether tracks are printed with one or two lines (representing the center line and rails) depends on the <strong>Print Scale</strong>. If this value is smaller than or equal to twice the Two Rail Scale on the Display (<a href="cmdDisplay.html#cmdDisplay">Section 2.10.3</a>) dialog then tracks are drawn with two lines. This corresponds to the way tracks are drawn on the main window, adjusted to account for the greater resolution of most printers. At 1:1 tracks are also drawn with a center line. +</p> +<dl><dt> +Other options: +</dt> +<dd> +<strong>Engineering Data</strong> - show title, user, date and other information in a box at the bottom of the printout. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Registration Marks</strong> - at 1:1 scale, print location markers every 3" (or 10cm). This option is only enabled at 1:1. This is useful for aligning multiple pages printed at different angles. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Page Numbers</strong> - to help positioning the individual pages the page number is printed in the center of the page in the format (x/y). x is the page position from left to right, y in from bottom to top, So (1/1) is the page at the bottom left. As an additional aid, the numbers of the next pages are printed on each edge. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Snap Grid</strong> - if the Snap Grid (<a href="cmdGrid.html#cmdGrid">Section 2.12.2</a>) is visible then it may be drawn on the printout. This option is only enabled if the <em>Snap Grid</em> is visible. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Rulers</strong> - choose to print rulers at the layout edge, or on all edges of the page, an option is only enabled if the <strong>Angle</strong> is <em>0.000</em>, or None - which means print no rulers. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Centerline below Scale 1:1</strong> - dotted line down the center of the Track/Roadbed. This line will always be printed at Scale 1:1, but selecting this option will print it at smaller scales. This option is disabled if tracks would be drawn with only one line (instead of two). +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Roadbed Outline</strong> - lines representing the edge of the Roadbed. The Roadbed will be printed if the <em>Width</em> is greater than the track gauge. Note: this option is most useful at 1:1. This option is disabled if tracks would be drawn with only one line (instead of two). +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Ignore Page Margins</strong> - use the physical page size. This allows the printouts to abut without trimming. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Margins</strong> - examine and update the printer margins for the current printer. (<a href="cmdPrintMargin.html#cmdPrintMargin">Section 2.5.11</a>) +</dd> +</dl> +<p> + +</p> +<dl><dt> +The orientation of the print grid is controlled by: +</dt> +<dd> +<strong>X</strong> - X co-ordinate. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Y</strong> - Y co-ordinate. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Angle</strong> - of the grid. +</dd> +</dl> +<p> +These values can be set directly or by dragging on the layout. <code>Shift+Left+Drag</code> moves the grid and <code>Shift+Right+Drag</code> rotates the grid. The <strong>Reset</strong> button resets the values to 0. +</p> +<p> +The <strong>Print</strong> button prints the selected pages and closes the <strong>Print</strong> dialog. It is not enabled until you have selected some pages to print. +</p> +<p> +The <strong>Setup</strong> button invokes the Printer Setup (<a href="printSetup.html#printSetup">Section 2.5.10</a>) dialog. +</p> +<p> +The <strong>Select All</strong> button selects all pages for printing. +</p> +<p> +The <strong>Clear</strong> button unselects all selected pages, so no pages will be printed. +</p> +<p> +<em>Suggested Uses:</em> +</p> +<p> +Use the <strong>Snapshot</strong> button to set the scale and orientation for a one-page printout of the layout. Also set <strong>Engineering Data</strong> to add the Layout Title, Scale and other data for a summary. +</p> +<p> +Use <strong>Layers</strong> (<a href="cmdLayer.html#cmdLayer">Section 2.9.5</a>) to control which tracks are visible (and printed). Put bench-work, scenery or different tracks levels in separate layers and hide the layers you are not working with. +</p> +<p> +To transfer the drawing to the layout without printing at 1:1, make the Snap Grid (<a href="cmdGrid.html#cmdGrid">Section 2.12.2</a>) visible and orient it to match your room or layout table. +</p> +<p> +Check the <strong>Print Snap Grid</strong> toggle and use the printed grid to transfer measurements to your layout space. You may want to change the color (<a href="cmdRgbcolor.html#cmdRgbcolor">Section 2.10.1</a>) of the <strong>Snap Grid</strong> to make it more visible on the printout. +</p> +<p> +When you print multiple pages you can check <strong>Ignore Page Margins</strong> so pages can be placed next to each other. The tracks will line up correctly without trimming or overlapping the pages. Note: depending on your printer there will be an unprintable margin around the edge of the page. +</p> +<p> +If you print at 1:1 for direct transfer to the sub-roadbed, check <strong>Print Roadbed Outline</strong> and set <strong>Width</strong> to show lines for making cuts. +</p> +<p> +If you make printouts in strips at different angles at 1:1 (to follow tracks around a curve), check <em>Print Registration Marks</em> to be able to align the separate strips. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Printer Setup</title> +<link rel="previous" href="cmdPrint.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="Linux.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="printSetup"></a>2.5.10 <a name="i0"></a>Printer Setup</h1> +<ul> +<li><a href="Linux.html#Linux">2.5.10.1 Linux</a></li> +<li><a href="MS-Windows.html#MS-Windows">2.5.10.2 Microsoft Windows</a></li> +</ul> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Linux</title> +<link rel="previous" href="printSetup.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MS-Windows.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="Linux"></a>2.5.10.1 <a name="i0"></a>Linux</h1> +<p> +<img src="png.d/printset.png"> +</p> +<p> +The <strong>Printer Setup</strong> dialog allows you to configure the application's use of the printer. +</p> +<p> +The <strong>Printer Setup</strong> window contains: +</p> +<dl><dd> +<strong>Format for</strong> - a list to select a particular printer. The entries on this list are defined by <code>printer</code> lines in the <code>~/.xtrkcad/xtrkcad.rc</code> file. The first entry, 'File', causes printouts to be sent to a file. You will be prompted for a file name when doing a print. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Paper Size</strong> - a list of various supported paper sizes. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Orientation</strong> - a Radio button to select various Landscape or Portrait formats. This setting is ignored, use the <strong>Page Format</strong> entry on the <strong>Print</strong> dialog. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Apply</strong> - updates the data and ends the dialog. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Cancel</strong> - ends the dialog without update. +</dd> +</dl> +<p> + +</p> +<p> +<em>Note</em> - Printing uses a default of 600ppi. It scales the print and text from a default size of 72dpi. This is often the expected value for a standard printer driver to work correctly, but will not work if the driver is not accurately setting the ppi available. To override the printer ppi you can use either the configuration file settings for print or environmental variables. These values are set in the Preferences section. +</p> +<ol><li> +Preferences.PrintScale - The floating point ratio of the real printer dpi to 72. +</li> +<li> +Preferences.PrintTextScale - The floating point ratio of the real printer text support to a dpi of 72. This value has no effect unless PrintScale is set to > 0.0. +</li> +</ol> +<p> + These values can also be set using environmental variables if the configuration preference values are not set or they are set to <=0.0. +</p> +<ol><li> +XTRKCADPRINTSCALE +</li> +<li> +XTRKCADPRINTTEXTSCALE +</li> +</ol> +<p> + +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Microsoft Windows</title> +<link rel="previous" href="Linux.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdPrintMargin.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MS-Windows"></a>2.5.10.2 <a name="i0"></a>Microsoft Windows</h1> +<p> +<img src="png.d/printset_win.png"> +</p> +<p> +The Windows <strong>Printer Setup</strong> dialog allows you to configure the application's use of the printer. +</p> +<p> +The <strong>Printer Setup</strong> window contains: +</p> +<dl><dd> +<strong>Name</strong> - a drop down list for selection of a particular printer. Entries in this list are defined by <code>Windows</code>. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Status</strong> - the current status of the selected printer. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Type</strong> - the type and model of printer selected. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Where</strong> - The location of the printer if it's defined in the printers properties. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Comment</strong> - Any comments defined that are defined in the printers properties. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Paper Size</strong> - a list of various North American and European paper sizes. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Paper Source</strong> - a list of various paper tray locations associated with the selected printer. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Orientation</strong> - a Radio button to select either Landscape or Portrait format. This setting is ignored, use the <strong>Page Format</strong> entry on the <strong>Print</strong> dialog. +</dd> +</dl> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Printer Margin</title> +<link rel="previous" href="MS-Windows.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="helpM.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdPrintMargin"></a>2.5.11 <a name="i0"></a>Printer Margin</h1> +<p> +<img src="png.d/printmargin.png"> +</p> +<p> +The <strong>Printer Margins</strong> dialog allows you to configure the selected printer's margins. +</p> +<p> +The margins for the four edges of the printed page are displayed. The default values are fetched from the Operating System. You can enter updated values if the System values don't match your actual printer. +</p> +<p> +The <strong>Reset</strong> is enabled if the displayed values don't match the System values and will reload the System's values. +</p> +<p> +To check your printer's margin: +</p> +<dl><dd> +Set <strong>Scale</strong> to 1 +</dd> +</dl> +<p> + +</p> +<dl><dd> +Set <strong>Origin</strong> and <strong>Angle</strong> to 0.000 by clicking the <strong>Reset</strong> button +</dd> +</dl> +<p> + +</p> +<dl><dd> +Enable <strong>Registration Marks</strong> this prints crosshairs every 3" or 10cm at scale 1:1. +</dd> +</dl> +<p> + +</p> +<dl><dd> +Enable <strong>Ignore Page Margins</strong> +</dd> +</dl> +<p> + +</p> +<dl><dd> +Select and <strong>Print</strong> the lower left page of you layout +</dd> +</dl> +<p> + +</p> +<dl><dd> +Measure the distance from the left and bottom edges to the Registration Mark at (3",3") or (10cm,10cm). +</dd> +</dl> +<p> + +</p> +<dl><dd> +Update the <strong>Printer Margin</strong> values for the left and bottom edges. You can also update the top and right edges. +</dd> +</dl> +<p> + +</p> +<p> +Margins values are stored for each printer. +</p> +<p> + +</p> +<p> +You can also load <strong>PrinterMarginTest-A4.xtc</strong> or <strong>PrinterMarginTest-Letter.xtc</strong> from <strong>Help|Examples</strong>. These files have registration lines in the corners to help determine your printer's margins. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Help Menu</title> +<link rel="previous" href="cmdPrintMargin.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdDemo.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="helpM"></a>2.6 Help Menu</h1> +<p> +<img src="png.d/mhelp.png"> +</p> +<p> +The <strong>Help Menu</strong> displays information on various topics. The contents of the menu vary depending on the operating system. +</p> +<dl><dd> +The <strong>Help</strong> command opens the Help Window at the Contents Page. +</dd> +<dd> +The <strong>Help Command Context</strong> command opens the Help Window at the page for the current Command. +</dd> +<dd> +<img src="png.d/mhelprecent.png"> +</dd> +<dd> +<em>Recent Messages</em> +</dd> +</dl> +<p> +The <strong>Recent Messages</strong> command opens a cascading menu containing recent error messages and notices you have received. Selecting one of them displays additional information about the message (<a href="messageList.html#messageList">Section C.2</a>). +</p> +<p> +The <strong>Collect Problem Info</strong> command helps you to put together the information and files that might help the developers to analyze and fix possible bugs. +</p> +<dl><dd> +<img src="png.d/problemdata.png"> +</dd> +<dd> +<em>Collect Problem Info</em> +</dd> +</dl> +<p> +The command removes userids and other private information from the files. The results are stored in a compressed (zip-) file and placed in the same directory as the affected layout file. +</p> +<dl><dd> +<img src="png.d/dtipofday.png"> +</dd> +<dd> +<em>Tip of The Day</em> +</dd> +</dl> +<p> +The <strong>Tip of the Day</strong> item displays a useful tip about the operation of <em>XTrackCAD</em>. By default, a new tip is displayed each time you start the program. +</p> +<dl><dd> +<img src="png.d/mhelpdemos.png"> +</dd> +<dd> +<em>Demo Menu</em> +</dd> +</dl> +<p> +The <strong>Demos</strong> command (<a href="cmdDemo.html#cmdDemo">Section 2.6.1</a>) opens a cascading menu which invokes various demonstrations of <em>XTrackCAD</em> features. +</p> +<p> +The <strong>Examples</strong> command displays the list of included example programs which you can examine. +</p> +<hr> +<ul> +<li><a href="cmdDemo.html#cmdDemo">2.6.1 Demo Mode</a></li> +</ul> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Demo Mode</title> +<link rel="previous" href="helpM.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdHotBar.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdDemo"></a>2.6.1 <a name="i0"></a>Demo Mode</h1> +<p> +The <strong>Demos</strong> menu item, under the <strong>Help</strong> (<a href="helpM.html#helpM">Section 2.6</a>) menu, shows a cascading menu of choices to demonstrate various features and commands. +</p> +<p> +<img src="png.d/mhelpdemos.png"> +</p> +<p> +In demonstration mode <em>XTrackCAD</em> is driven by a script file (such as created by the <strong>Record</strong> (<a href="macroM.html#macroM">Section 2.8</a>) command). The cursor is simulated on the Main Window (<a href="mainW.html#mainW">Section 3.1</a>) and the <em>XTrackCAD</em> windows (except the <strong>Demo</strong> window) are inactive. Also, simulated input on dialogs is indicated by a border momentarily drawn around the control. +</p> +<p> +The <strong>Demo</strong> dialog is displayed which contains a number of control buttons and a text area that shows comments on the demonstration being run. +</p> +<dl><dd> +<img src="png.d/demo.png"> +</dd> +</dl> +<ul><li> +<strong>Next</strong> - skip to the next demonstration. If you hold down the <em>Shift</em> key then you will jump back to the previous demonstration. +</li> +</ul> +<p> + +</p> +<ul><li> +<strong>Quit</strong> - quit demonstration mode. +</li> +</ul> +<p> + +</p> +<ul><li> +<strong>Speed</strong> - controls the speed of the demonstration. +</li> +</ul> +<p> + +</p> +<ul><li> +<strong>Step</strong> - advance to the next step of the current demonstration. +</li> +</ul> +<p> +The state of the layout is saved when running demonstrations. +</p> +<p> +A number of options and controls (such as scale) are changed while running demonstrations. These will be restored when the demonstration is finished. +</p> +<p> +You can adjust Window sizes and positions while the demonstration is running to better see what is happening. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Hot Bar</title> +<link rel="previous" href="cmdDemo.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="Flex-track.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdHotBar"></a>2.7 Hot Bar</h1> +<p> +<img src="png.d/hotbar.png"> +</p> +<p> +The <em>Hot Bar</em> starts with a flex-track of the current gauge, and then a scrolling list of all the turnouts, sectional track and structures available through the Turnout (<a href="cmdNewFixedTrack.html#cmdNewFixedTrack">Section 2.1.8</a>) and Structure (<a href="cmdStructure.html#cmdStructure">Section 2.1.7</a>) commands. The Description and/or Part Number under each object can be displayed by enabling the <em>Hot Bar Labels</em> radio button on the Display (<a href="cmdDisplay.html#cmdDisplay">Section 2.10.3</a>) dialog. +</p> +<p> +Only those items taken from files which are in the current scale/gauge are displayed in the HotBar. They are shown in order - A Flex-track - then the Contents of Files in the File->Parameter Files... List in listed order - and then any Custom objects created in this Layout as listed in the Manage->Custom Defined Parts dialog. +</p> +<p> +The arrow buttons on either side of the <em>Hot bar</em> move the list one object to the right or left. Holding down the Shift key will move the list by greater amounts. About eight <code>Shift+Click</code>s are required to move the list through the entire range of objects. Also, pressing the keys <code>1</code> through <code>9</code> and <code>0</code> will cause the <em>Hot Bar</em> to jump relative spots on the list. +</p> +<p> +A <code>Right-Click</code> over the <em>Hot Bar</em> will display a pop-up menu listing the files with contents on the <em>Hot Bar</em>. Selecting an item from this list causes the <em>Hot Bar</em> to jump to the relative spot on the whole list. +</p> +<p> +Objects on the <em>Hot Bar</em> are placed on the drawing canvas by first selecting an object by <em>Cicking</em> it on the <em>Hot Bar</em>. Then <em>Click</em> and <em>Drag</em> on the Main window, rotating it with <code>Right-Drag</code> to position it, and then pressing the <code>Space</code> key to set it in place. +</p> +<p> +For <em>Turnouts</em>, see below for additional details on the <em>Active EndPoint</em>. +</p> +<hr> +<ul> +<li><a href="Flex-track.html#Flex-track">2.7.1 Flex-track</a></li> +<li><a href="hbStructures.html#hbStructures">2.7.2 Structures</a></li> +<li><a href="hbTurnouts.html#hbTurnouts">2.7.3 Turnouts</a></li> +</ul> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Flex-track</title> +<link rel="previous" href="cmdHotBar.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="hbStructures.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="Flex-track"></a>2.7.1 <a name="i0"></a>Flex-track</h1> +<p> +A Flex-track unit can be placed for convienience on the left-hand side of the HotBar. This is can be hidden by an option in <a href="cmdPref.html#cmdPref">Section 2.10.7</a>. It can be recognised because it is the only diagonally facing track element and has a label "FLEX". It is used by <code>Left-Click</code> selecting it, and <code>Left-Click</code> clicking on the layout where the first end should be placed, and then <code>Left-Click</code> for the second end. If either end is over an unconnected end and <strong>Shift</strong> was not held, the flex-track will be connected to the track and the end angle and radius will be set from the track. If an end was not over an unconnected end, it can be manipulated by left dragging out the end angle before releasing. If the second end is not on a track end, differing end angles will produce a smooth curve, if both ends are unconnected, simply <code>Left-Click</code> without dragging produces a straight track. Once both ends have been defined, the track can then be manipulated like a <a href="chgCornu.html#chgCornu">section 2.2.8.8</a> Cornu Curved Track, by selecting and moving ends, adding and removing "pins" and altering the end anchor angle and radius if the flex-track is not connected at that end. If the disconnected end is dragged and the button released while over an open end of another track, it will be connected to it in the manner of a Join with a Cornu easement. +</p> +<p> +A Flex-track will form a Straight Track if the ends have zero radius and are in a line with opposed end angles. If the ends are not aligned but the end angles are opposed it will be a simple S-curve. It will be a smooth monotonic curve if the ends are not in a line and the end angle lines and chord form a triangle. Otherwise it will be a complex S-curve. . +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Structures</title> +<link rel="previous" href="Flex-track.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="hbTurnouts.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="hbStructures"></a>2.7.2 <a name="i0"></a>Structures</h1> +<p> +<em>Structures</em> are placed on the layout in the same way as turnouts (<a href="hbTurnouts.html#hbTurnouts">Section 2.7.3</a>) except no Active EndPoint exists and they do not align with existing track. +</p> +<p> +Refer to <a href="cmdStructure.html#cmdStructure">Section 2.1.7</a> for information pertaining to use of the <em>Structure</em> dialog. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Turnouts</title> +<link rel="previous" href="hbStructures.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="macroM.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="hbTurnouts"></a>2.7.3 <a name="i0"></a>Turnouts</h1> +<p> +<em>Turnouts</em> have an <em>Active EndPoint</em> (<a href="generalTerms.html#generalTerms">Section B.2</a>) which is the handle used to position the <em>Turnout</em>. You can change the <em>Active EndPoint</em> by a <code>Shift+Left-Click</code> which causes the next endpoint to become Active. +</p> +<p> +If you <code>Left+Drag</code> a turnout onto a track, the Active EndPoint (<a href="generalTerms.html#generalTerms">Section B.2</a>) is aligned with the selected track. On flex-track, you can flip the turnout by moving the cursor from one side of the track centerline to the other. On another turnout, the new turnout will be placed at the endpoint closest to the cursor. +</p> +<p> +<em>XTrackCAD</em> will automatically connect the turnout's endpoints to any other tracks they are aligned with. The number of endpoints that will be connected is displayed on the Status Bar, as well as the Maximum displacement between these endpoints and the tracks they will be connected to. <em>XTrackCAD</em> will adjust the position of the Turnout to give you the best fit for locating the turnout. You can override this adjustment by holding down the <em>Shift</em> key while <em>Dragging</em>. +</p> +<p> +<code>Right+Drag</code> or <code>Ctrl+Left+Drag</code> (<a href="windowTerms.html#windowTerms">Section B.1</a>) can be used to rotate the turnout on the layout. <code>Shift+Right-Click</code> (<a href="cmdAcclKeys.html#cmdAcclKeys">Section 3.4</a>) displays a pop-up menu allowing you to rotate the turnout by various angles. +</p> +<p> +When you press the <code>Space</code> key, the turnout is positioned on the layout. Any tracks that are aligned with any of the turnout's endpoints will be connected to the turnout automatically. If you are using the Turnout (<a href="cmdNewFixedTrack.html#cmdNewFixedTrack">Section 2.1.8</a>) command then you can also click the <em>OK</em> button on the dialog. +</p> +<p> +If you choose another turnout or change commands after beginning to place a turnout on the layout, the turnout will be created as if it is attached to another track. Otherwise it will be removed. +</p> +<p> +If the Drawing Scale is smaller or equal to the Label Scale (<a href="cmdDisplay.html#cmdDisplay">Section 2.10.3</a>) then Turnouts will be labeled with their description when drawn. The individual labels can be can be turned off by the Move Description(<a href="cmdMoveLabel.html#cmdMoveLabel">Section 2.2.10</a>) command, or all Turnout labels can be disabled by using the Display (<a href="cmdDisplay.html#cmdDisplay">Section 2.10.3</a>) dialog. As well, the length of any connected Flex-track will be indicated at each endpoint. +</p> +<p> +Refer to <a href="cmdNewFixedTrack.html#cmdNewFixedTrack">Section 2.1.8</a> for information pertaining to use of the <em>Turnout</em> dialog. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Macro Menu</title> +<link rel="previous" href="hbTurnouts.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="manageM.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="macroM"></a>2.8 Macro Menu</h1> +<p> +<img src="png.d/mmacro.png"> +</p> +<p> +The <strong>Macro Menu</strong> shows commands that can be used to <strong>Record</strong> and <strong>Playback</strong> commands. +</p> +<dl><dd> +<strong>Record</strong> - Displays the <strong>Record</strong> dialog (after prompting for a file name). The current layout state and most subsequent actions will be saved in the recording file. +<p> + +</p> +<ul><li> +Messages can be inserted into the recording file by pressing the <strong>Message</strong> button on the <strong>Record</strong> dialog then entering a message in the text display. +</li> +</ul> +<p> + +</p> +<ul><li> +Press the <strong>End</strong> button to end entry of the message and resume recording. +</li> +</ul> +<p> + +</p> +<ul><li> +Press the <strong>Stop</strong> button to stop recording. +</li> +</ul> + +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Playback</strong> - Displays the <strong>Playback</strong> dialog (after prompting for a file name). This is used to playback previously recorded sessions. <strong>Note:</strong> the layout state will be saved during playbacks and restored after. +</dd> +</dl> +<p> +The <strong>Record</strong> command is useful if it becomes necessary to report a bug in <em>XTrackCAD</em>. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Manage Menu</title> +<link rel="previous" href="macroM.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdCarinv.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="manageM"></a>2.9 <a name="i0"></a>Manage Menu</h1> +<p> +<img src="png.d/mmanage.png"> +</p> +<p> +The <strong>Manage Menu</strong> shows commands affecting the <strong>Main Canvas</strong> (<a href="mainW.html#mainW">Section 3.1</a>). +</p> +<dl><dd> +<strong>Car Inventory</strong> - displays the dialog (<a href="cmdCarinv.html#cmdCarinv">Section 2.9.1</a>) to update your list of cars and locomotives. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Custom Management</strong> - displays the <strong>Custom Management</strong> (<a href="cmdCustmgm.html#cmdCustmgm">Section 2.9.2</a>) dialog to manipulate custom turnout, structure and rolling stock designs. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Layout Control Elements</strong> - display the <strong>Layout Control Elements</strong> (<a href="cmdContmgm.html#cmdContmgm">Section 2.9.3</a>) dialog to manipulate blocks, turnout motors and signals. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Group</strong> - creates a <strong>Structure</strong> or <strong>Turnout</strong> definition from the selected (<a href="cmdSelect.html#cmdSelect">Section 2.2.16</a>) objects. See the <strong>Group</strong> command (<a href="cmdGroup.html#cmdGroup">Section 2.9.4</a>) for details. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Layers</strong> - displays the Layer (<a href="cmdLayer.html#cmdLayer">Section 2.9.5</a>) dialog. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Parts List</strong> - Invokes the Parts List (<a href="cmdEnum.html#cmdEnum">Section 2.9.6</a>) command. This command produces a list of all selected turnouts and sectional tracks and the total length of flex-track. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Price List</strong> - Displays the <strong>Price List</strong> (<a href="cmdPricelist.html#cmdPricelist">Section 2.9.7</a>) dialog to specify prices for tracks and structures. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Train</strong> - Run trains on the designed layout +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Turnout Designer</strong> - displays a menu list of Turnout Designer (<a href="cmdTurnoutNew.html#cmdTurnoutNew">Section 2.9.9</a>) dialogs. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Ungroup</strong> - breaks apart any selected (<a href="cmdSelect.html#cmdSelect">Section 2.2.16</a>) turnouts and structures into their basic lines (<a href="cmdDraw.html#cmdDraw">Section 2.3</a>) and track segments. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Update Turnout and Structures</strong> - replaces (<a href="cmdRefreshSpecial.html#cmdRefreshSpecial">Section 2.9.10</a>) any selected (<a href="cmdSelect.html#cmdSelect">Section 2.2.16</a>) <strong>Turnouts</strong> and <strong>Structures</strong> with the definitions from updated <strong>parameter files</strong> (<a href="cmdPrmfile.html#cmdPrmfile">Section 2.5.7</a>). +</dd> +</dl> +<hr> +<ul> +<li><a href="cmdCarinv.html#cmdCarinv">2.9.1 Car Inventory</a></li> +<ul> +<li><a href="cmdCarpart.html#cmdCarpart">2.9.1.1 Car Item Dialog</a></li> +<li><a href="carpart.html#carpart">2.9.1.2 Car Part Dialog</a></li> +<li><a href="carprototype.html#carprototype">2.9.1.3 Car Prototype Dialog</a></li> +</ul> +<li><a href="cmdCustmgm.html#cmdCustmgm">2.9.2 Custom Management</a></li> +<li><a href="cmdContmgm.html#cmdContmgm">2.9.3 Layout Control Elements Dialog</a></li> +<li><a href="cmdGroup.html#cmdGroup">2.9.4 Group Dialog</a></li> +<li><a href="cmdLayer.html#cmdLayer">2.9.5 Layers Dialog</a></li> +<li><a href="cmdEnum.html#cmdEnum">2.9.6 Parts List </a></li> +<li><a href="cmdPricelist.html#cmdPricelist">2.9.7 Price List</a></li> +<li><a href="cmdTrain.html#cmdTrain">2.9.8 Train Mode </a></li> +<li><a href="cmdTurnoutNew.html#cmdTurnoutNew">2.9.9 Turnout Designer</a></li> +<li><a href="cmdRefreshSpecial.html#cmdRefreshSpecial">2.9.10 Update Turnouts and Structures</a></li> +<li><a href="cmdUngroup.html#cmdUngroup">2.9.11 Ungroup</a></li> +</ul> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Car Inventory</title> +<link rel="previous" href="manageM.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdCarpart.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdCarinv"></a>2.9.1 <a name="i0"></a>Car Inventory</h1> +<p> +This dialog is used to manage your list of cars and locomotives. +</p> +<p> +<img src="png.d/carinv.png"> +</p> +<p> +The main part of this dialog contains a detailed list of each car and locomotive in your inventory. The list can be sorted on different columns by selecting column names in the <strong>Sort Drop Down Lists</strong> along the top of the dialog. The width of the columns can be adjusted by <em>Left+Drag</em> on the lines between the column titles. +</p> +<p> +Cars are placed on the layout by using the <strong>Train Simulation</strong> (<a href="cmdTrain.html#cmdTrain">Section 2.9.8</a>) command. +</p> +<p> +The <strong>Find</strong> button will center the <strong>Main Window</strong> (<a href="mainW.html#mainW">Section 3.1</a>) on the selected car. This button is only enabled for cars which are on the Layout (indicated by co-ordinates in the Location column). If the car on a track that is hidden and <strong>Trains on Hidden Track</strong> (<a href="cmdDisplay.html#cmdDisplay">Section 2.10.3</a>) is set to <strong>Hide</strong>, then the car (and any attached cars) will be made visible. +</p> +<p> +The <strong>Edit</strong> button invokes the <strong>Car</strong> dialog (<a href="cmdCarpart.html#cmdCarpart">Section 2.9.1.1</a>) to modify the selected car. This button is disabled if more than one (or no) car is selected or if the selected car is on the Layout. +</p> +<p> +The <strong>Add</strong> button is to add a new Car. Refer to <a href="faqsPrototype.html#faqsPrototype">Section A.3</a> if an error occurs when attempting to add inventory to this list. +</p> +<p> +The <strong>Delete|Shelve</strong> button serves two functions: If all selected cars are on the layout then this button shows <strong>Shelve</strong> and it moves them from the layout and returns them to the <strong>Shelf</strong>. If all selected cars are on the <strong>Shelf</strong> then this button shows <strong>Delete</strong> and they will be deleted from the Inventory. Otherwise, the button is blank and disabled. +</p> +<p> +The <strong>Import</strong> and <strong>Export</strong> buttons read and write a <em>Comma-Separated-Value (CSV)</em> file. This file format can be read and written by many applications. It can be used to transfer car inventory data between different applications. This file contains the following columns (the first four are required when Importing): +</p> +<dl><dd> +<em>Scale</em> - example: HO, HOn3, N, O etc +</dd> +</dl> +<p> + +</p> +<dl><dd> +<em>Manufacturer</em> and <em>Partno</em> +</dd> +</dl> +<p> + +</p> +<dl><dd> +<em>Prototype</em> - example: GP40 +</dd> +</dl> +<p> + +</p> +<dl><dd> +<em>Index</em> - an unique numeric identifier (optional) +</dd> +</dl> +<p> + +</p> +<dl><dd> +<em>Roadname</em>, <em>Repmark</em> and <em>Number</em> - example: Burlington Northern, BN, 1234 +</dd> +</dl> +<p> + +</p> +<dl><dd> +<em>Type</em> - enter one of the following: +<ul><li> +10101(Diesel), +</li> +<li> +10201(Steam), +</li> +<li> +10301(Electric), +</li> +<li> +30100(Freight), +</li> +<li> +50100(Passenger), +</li> +<li> +70100(M-O-W) or; +</li> +<li> +90100(Other) +</li> +</ul> + +</dd> +</dl> +<p> + +</p> +<dl><dd> +<em>Options</em> - bit map of +<ul><li> +0x0001 - Body Mounted Couplers +</li> +<li> +0x0002 - Locomotive +</li> +<li> +Other bits can be ignored +</li> +</ul> + +</dd> +</dl> +<p> + +</p> +<dl><dd> +<em>CarLength</em>, <em>CarWidth</em>, <em>CoupledLength</em>, <em>Truch Center Offset</em> and <em>TruckCenter</em> - car dimensions in inches +</dd> +</dl> +<p> + +</p> +<dl><dd> +<em>Color</em> - encoded as (Red * 65536 + Green * 256 + Blue) +</dd> +</dl> +<p> + +</p> +<dl><dd> +<em>PurchPrice</em>, <em>CurrPrice</em>, <em>PurchDate</em> and <em>ServiceDate</em> - numeric values - dates are in the form yyyymmdd, where yyyy is the year, mm the month, dd the day +</dd> +</dl> +<p> + +</p> +<dl><dd> +<em>Condition</em> - enter one of the following: +<ul><li> +100(Mint), +</li> +<li> +80(Excellent), +</li> +<li> +60(Good), +</li> +<li> +40(Fair), +</li> +<li> +20(Poor) or; +</li> +<li> +0(N/A) +</li> +</ul> + +</dd> +</dl> +<p> + +</p> +<dl><dd> +<em>Notes</em> - free form text +</dd> +</dl> +<p> +The <strong>List</strong> button creates a text file listing your inventory. +</p> +<hr> +<ul> +<li><a href="cmdCarpart.html#cmdCarpart">2.9.1.1 Car Item Dialog</a></li> +<li><a href="carpart.html#carpart">2.9.1.2 Car Part Dialog</a></li> +<li><a href="carprototype.html#carprototype">2.9.1.3 Car Prototype Dialog</a></li> +</ul> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Car Item Dialog</title> +<link rel="previous" href="cmdCarinv.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="carpart.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdCarpart"></a>2.9.1.1 <a name="i0"></a>Car Item Dialog</h1> +<p> +This dialog is invoked from the <strong>Car Inventory</strong> (<a href="cmdCarinv.html#cmdCarinv">Section 2.9.1</a>) and the <strong>Custom Management</strong> (<a href="cmdCustmgm.html#cmdCustmgm">Section 2.9.2</a>) dialogs. +</p> +<p> +The dialog can be displayed in three different ways and is used to create or edit <strong>Car Items</strong>, <strong>Car Part</strong> definitions or <strong>Prototype</strong> definitions. +</p> +<p> +The <strong>Add</strong> button creates a new definition. The dialog remains open so you can enter multiple definitions. You can <strong>Close</strong> the dialog when you are finished. If you are editing an existing definition then the <strong>Add</strong> button will be replaced by the <strong>Update</strong> button which updates the selected definition and closes the dialog. +</p> +<p> +The <strong>New</strong> button on the <strong>Car Item</strong> dialog invokes the <strong>Car Part</strong> or <strong>Car Prototype</strong> dialog which you can use to create new part or prototype definitions for your cars. The <strong>New</strong> button on the <strong>Car Part</strong> dialog invokes the <strong>Car Prototype</strong> dialog. +</p> +<p> +<strong>Car Item Dialog</strong> +</p> +<p> +<img src="png.d/caritem.png"> +</p> +<p> +The dialog contains: +</p> +<dl><dd> +<strong>Car Description</strong> which contains lists of <strong>Manufacturer</strong>, <strong>Prototype</strong> and <strong>Part Number</strong> which are used to select the Car Part. The <strong>Manufacturer</strong> list contains the entries <strong>Custom</strong> and <strong>Unknown</strong> for special Car Parts. For these entries you can enter the <strong>Part Number</strong> and <strong>Description</strong> fields. +<p> + +</p> +<ul><li> +If the manufacturer of your car is not listed in the <strong>Manufacturer</strong> list you can type in the new name. Also, if the <strong>Part</strong> is not listed you can enter a new part number. The new part will be added to the list of Custom Car Parts (<a href="cmdCustmgm.html#cmdCustmgm">Section 2.9.2</a>). +</li> +</ul> + +</dd> +</dl> +<p> + +</p> +<dl><dd> +The <strong>Mode</strong> Radio button group lets you choose between the <strong>Information</strong> controls described here or the <strong>Customize</strong> controls described in the next section. You would use the <strong>Customize</strong> option to change Road name, Number or Color if you have repainted the car or to adjust the dimensions. +</dd> +</dl> +<p> + +</p> +<dl><dd> +Details about the individual car item such as <strong>Index</strong>, <strong>Price</strong> and <strong>Condition</strong>, <strong>Dates</strong> and <strong>Notes</strong>. The <strong>Index</strong> value must be unique for all car items. +<p> + +</p> +<ul><li> +To enter multiple <strong>New Cars</strong> you can set the <strong>Quantity</strong> field to a value greater than one. The <strong>Numbers</strong> Radio button group specifies whether the new car's numbers will be sequential (such as 1234, 1235, ...) or repeated. +</li> +</ul> + +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Message Line</strong> which will contain instructions if there any fields that need to be completed. +</dd> +</dl> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Car Part Dialog</title> +<link rel="previous" href="cmdCarpart.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="carprototype.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="carpart"></a>2.9.1.2 <a name="i0"></a>Car Part Dialog</h1> +<p> +This dialog is similar the the <strong>Car Item</strong> dialog except that the <strong>Car Item Information</strong> section is not displayed. The <strong>Manufacturer</strong> Drop Down List is editable so you can enter a new manufacturer, and you must enter a <strong>Part Number</strong>. If you are adding a new car part, the <strong>Part Number</strong> field will be incremented (if it is a numeric value) so you can enter a number of car parts. +</p> +<p> +<img src="png.d/carpart.png"> +</p> +<p> +The middle section contains: +</p> +<dl><dd> +The <strong>Road</strong>, <strong>Reporting Mark</strong>, <strong>Number</strong> and <strong>Color</strong>. You can choose a <strong>Road name</strong> from the list of known road names or enter a new value. If known, the <em>reporting mark</em> (road name abbreviation) is filled in. These values control what label content is shown for Cars. If a reporting number is present the rep mark and the rep number will be used if the Cars Label Option is on in <a href="cmdDisplay.html#cmdDisplay">Section 2.10.3</a> +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Car Dimensions</strong> which contain the major dimensions of the car and how the coupler is mounted on the car. The <strong>Coupler Length</strong> is measured from the edge of the car body to the pulling face of the coupler. It is equivalent to half the separation between two coupled cars. +<p> + +</p> +<ul><li> +When entering values, the <code>p</code> key will convert a prototype measurement to a scale measurement. +</li> +</ul> +<p> + +</p> +<ul><li> +The length dimension has the following relationship, so changing one value will affect the others: +<p> + +</p> +<dl><dd> +<strong>Coupled Length = Car Length + 2 * Coupler Length</strong> +</dd> +</dl> +<p> + +</p> +<dl><dd> +The <em>Center Offset</em> moves the center of the two trucks from the center of the Car. This is a common feature of steam locomotives and means the envelope of the engine requires greater seperation between tracks on small radius curves. The minimum clearance needed can be seen by placing the car with the greatest distance from the center of the trucks to the corner on the inner radius and the car with the greatest distance between the trucks on the outer radius. See NMRA TN-7 Curved Track Centerline and Obstacle Clearance Calculation Methodology. +</dd> +</dl> + +</li> +</ul> + +</dd> +</dl> +<p> + +</p> +<dl><dd> +A diagram showing the position of the trucks and couplers. +</dd> +</dl> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Car Prototype Dialog</title> +<link rel="previous" href="carpart.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdCustmgm.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="carprototype"></a>2.9.1.3 <a name="i0"></a>Car Prototype Dialog</h1> +<p> +This dialog is used to create or edit prototype definitions. +</p> +<p> +<img src="png.d/carproto.png"> +</p> +<p> +The first section contains the name of the <strong>Prototype</strong> and its <strong>Type</strong>. +</p> +<p> +If this dialog was invoked from the <strong>Car Item</strong> or <strong>Car Part</strong> dialog then the prototype diagram will be copied from the selected part. Otherwise, the prototype is drawn as the default image which is a simple blue rectangle or, if it is a locomotive, with one end angled. +</p> +<p> +The <strong>Import</strong> button creates a prototype definition from the selected (<a href="cmdSelect.html#cmdSelect">Section 2.2.16</a>) lines and shapes. To use this, first create a set of shapes (<strong>Filled Rectangles, Polygons, Circles, Lines</strong> etc) using the Draw (<a href="cmdDraw.html#cmdDraw">Section 2.3</a>) commands on the main canvas. <strong>Select</strong> the shapes and use the <strong>Import</strong> button. +</p> +<p> +The <strong>Reset</strong> button will reset the figure to the default image. +</p> +<p> +If this dialog is invoked by the <strong>New</strong> button on the <strong>Car</strong> or <strong>Car Part</strong> dialog then the initial image will be copied from the prototype displayed on those dialogs. You can use this to make variations of existing prototypes. +</p> +<p> +The <strong>Color</strong> control on the <strong>Car Part</strong> dialog will replace any color of the <strong>Imported</strong> shapes which is not Black or a shade of gray with the selected hue. +</p> +<p> +The <strong>Flip</strong> button flips the diagram horizontally. For locomotives, the forward direction is to the right. +</p> +<p> +Unlike the other dialogs, dimensions in this dialog are in prototype units. When entering values, the <code>s</code> key will convert a scale measurement to a prototype measurement. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Custom Management</title> +<link rel="previous" href="carprototype.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdContmgm.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdCustmgm"></a>2.9.2 <a name="i0"></a>Custom Management</h1> +<p> +The <strong>Custom Management</strong> dialog allows you change the properties of turnouts, sectional track, structures, car parts and prototypes you have designed with the <strong>Turnout Designer</strong> (<a href="cmdTurnoutNew.html#cmdTurnoutNew">Section 2.9.9</a>), <strong>Group</strong> (<a href="cmdGroup.html#cmdGroup">Section 2.9.4</a>) or <strong>Car</strong> (<a href="cmdCarpart.html#cmdCarpart">Section 2.9.1.1</a>) commands. You can also move selected objects to a <strong>Parameter File</strong> (<a href="cmdPrmfile.html#cmdPrmfile">Section 2.5.7</a>). +</p> +<p> +<img src="png.d/custmgm.png"> +</p> +<p> +The <strong>Edit</strong> button invokes the appropriate designer or editor dialog for the selected item. This button is disabled if more than one (or no) object is selected. +</p> +<dl><dd> +The <strong>Turnout Designer</strong> (<a href="cmdTurnoutNew.html#cmdTurnoutNew">Section 2.9.9</a>) is used to modify the selected turnout design. If you wish to modify cosmetic details on a turnout or sectional track use the <strong>Group</strong> (<a href="cmdGroup.html#cmdGroup">Section 2.9.4</a>) command to add them to an existing definition. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Structures</strong> and old <strong>Turnout Designs</strong> use the <strong>Rename Dialog</strong> to change the Manufacturer, Description or Part Number values. For these objects the <strong>Edit</strong> button's label changes to <strong>Rename</strong>. <strong>Structures</strong> are not edited using this dialog but by using the <strong>Ungroup</strong> (<a href="cmdUngroup.html#cmdUngroup">Section 2.9.11</a>) and <strong>Group</strong> (<a href="cmdGroup.html#cmdGroup">Section 2.9.4</a>) commands. +</dd> +</dl> +<p> + +</p> +<dl><dd> +The <strong>Car</strong> (<a href="cmdCarpart.html#cmdCarpart">Section 2.9.1.1</a>) dialog is used to modify <strong>Car Prototype</strong> and <strong>Car Parts</strong>. +</dd> +</dl> +<p> +The <strong>Delete</strong> button removes the selected entries from the <code>xtrkcad.cus</code> (<a href="directories.html#directories">Section 1.9</a>) file when you exit the dialog. +</p> +<p> +The <strong>Move To</strong> button moves the selected entries to a <strong>Parameter File</strong> (<a href="cmdPrmfile.html#cmdPrmfile">Section 2.5.7</a>). If the <strong>Parameter File</strong> does not currently exist than you will be prompted to supply a contents description line for the file. In case the parameter file already exists, the selected entries are appended to this file. +</p> +<p> +The <strong>New</strong> buttons invokes the Car (<a href="cmdCarpart.html#cmdCarpart">Section 2.9.1.1</a>) dialog to create a new <strong>Car Prototype</strong> or <strong>Car Part</strong>. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Layout Control Elements Dialog</title> +<link rel="previous" href="cmdCustmgm.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdGroup.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdContmgm"></a>2.9.3 <a name="i0"></a>Layout Control Elements Dialog</h1> +<p> +This dialog is used to manage layout control elements (blocks, switchmotors, and signals). +</p> +<p> +Control Elements are elements related to layout control: blocks (occupancy detection), switchmotors (actuators to "throw" turnouts), signals, controls (other actuator or output devices), and sensors (other sensor or input devices). These elements don't relate to directly "physical" items on the layout, but instead refer to the elements used by the layout control software. These elements contain "scripts", which are really just textual items that provide information for the layout control software and provide a bridge between physical layout elements (like tracks or turnouts) and the layout control software. These textual items could be actual software code or could be LCC Events (for I/O device elements on a LCC network) or DCC addresses for stationary decoders, etc. XTrackCAD does not impose any sort of syntax or format -- that is left up to other software that might load and parse the XTrkCAD layout file. All that XTrackCAD does is provide a unified place for this information to be stored and to provide a mapping (association) between this control information and the layout itself. +</p> +<p> +<img src="png.d/lcemanager.png"> +</p> +<p> +The main part of this dialog contains a list of the currently defined layout control elements (blocks, switchmotors, signals, controls, and sensors), along with the tracks they relate to. These elements are added to the layout either from their Hotbar menus or from the Add menu. +</p> +<p> +The <strong>Edit</strong> button allows for editing a control element. And the <strong>Delete</strong> button deletes the selected element(s). +</p> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Group Dialog</title> +<link rel="previous" href="cmdContmgm.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdLayer.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdGroup"></a>2.9.4 <a name="i0"></a>Group Dialog</h1> +<p> +The <strong>Group</strong> command combines the selected (<a href="cmdSelect.html#cmdSelect">Section 2.2.16</a>) Lines and Shapes (<a href="cmdDraw.html#cmdDraw">Section 2.3</a>) to create structures (<a href="cmdHotBar.html#cmdHotBar">Section 2.7</a>). You can give the structure (<a href="cmdHotBar.html#cmdHotBar">Section 2.7</a>) a title consisting of Manufacturer, Description and Part Number on the <strong>Group</strong> dialog. +</p> +<p> +<img src="png.d/cgroup.png"> +</p> +<p> +The title will be pre-populated with the title of the last <strong>Structure</strong> you <strong>ungrouped</strong> (<a href="manageM.html#manageM">Section 2.9</a>). +</p> +<p> +You can include <strong>Turnouts</strong>, <strong>Sectional</strong>, <strong>Straight</strong> or <strong>Curved</strong> tracks in the selected objects which allows you to add cosmetic details to a <strong>Turnout</strong> definitions, or create a new <strong>Turnout</strong> definition. This can also be used to if there are fixed-track locations on a structure, like on an engine shed. +</p> +<p> +<strong>Group</strong> is intended to operate on simple groups of track segments. If you intend to group a large number of track segments, you should consider using <strong>Import Module</strong> (see <a href="cmdLayer.html#cmdLayer">Section 2.9.5</a>), +</p> +<p> +To modify a <strong>Structure</strong> or <strong>Turnout</strong> definition, first place the object on the layout, select and then <strong>Ungroup</strong> the object. Now the parts of the object can be edited using the <strong>Modify</strong> (<a href="cmdModify.html#cmdModify">Section 2.2.8</a>), <strong>Draw</strong> (<a href="cmdDraw.html#cmdDraw">Section 2.3</a>) or other commands. Once completed, select the object parts and use the <strong>Group</strong> command to update the definition (or create a new one by changing the title). +</p> +<p> +The <strong>Group</strong> dialog shows the Manufacturer, Description and part number (Title) of the new definition. Initial values are based on selected turnouts and structures or on the last <strong>Ungroup</strong>ed object (<a href="cmdUngroup.html#cmdUngroup">Section 2.9.11</a>). The <strong>Turntable/TransferTable/DblSlipSwitch</strong>? toggle button controls whether non-conflicting <strong>Paths</strong> should be combined or keep separate, see <strong>Paths</strong> below. The <strong>Replace with new group</strong>? toggle button is used if you want to replace the selected objects with the new definition. All fields listed in this dialog window must contain data. +</p> +<p> +The definition data will be added to the <code>xtrkcad.cus</code> (<a href="directories.html#directories">Section 1.9</a>) file for later use. Please consider contributing this information for others to use. +</p> +<p> +If you modify a definition from a <em>XTrackCAD</em> Library parameter file, the new definition will replace the existing definition on the <strong>Hot Bar</strong> (<a href="cmdHotBar.html#cmdHotBar">Section 2.7</a>), otherwise it will be added to the end of the <strong>Hot Bar</strong>. You can use the <strong>Custom Management</strong> (<a href="cmdCustmgm.html#cmdCustmgm">Section 2.9.2</a>) dialog to change the title or delete custom definitions. +</p> +<p> +<strong>Note:</strong> The selected tracks are decomposed into segments, which are simple tracks and drawing object (lines, curves, polygons ... ). Any track segments must appear in the first 127 segments. This implies a limit of 127 track segments. +</p> +<dl><dd> +You can re-order the segment list by +<ul><li> +Ungroup the selected tracks +</li> +<li> +Unselect all, and select the tracks you want to group +</li> +<li> +<strong>Move selected objects to bottom</strong> +</li> +<li> +Add the non-tracks object to the selected track segments +</li> +<li> +Retry the <strong>Group</strong> command +</li> +</ul> + +</dd> +</dl> +<p> +<strong>Paths</strong> define which segments are followed by a train in Train mode. Normally, if two paths follow paths of separate segments, then the paths are combined. For example a simple turnout would have two paths, but since the paths share some common segments, the paths are not combined. A Crossing has two paths but since they don't have any segments in common, the two paths are combined into one. A Turntable can have many distinct paths but only one would be valid at any time. In this case we don't want to combine paths and the toggle would be checked. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Layers Dialog</title> +<link rel="previous" href="cmdGroup.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdEnum.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdLayer"></a>2.9.5 <a name="i0"></a>Layers Dialog</h1> +<p> +Each object is contained in a layer - which is a custom group of objects that do not have a particular visual order, but can be treated as a set for certain commands. Objects which are created independently of other objects (such as straight tracks (<a href="cmdStraight.html#cmdStraight">Section 2.1.6</a>) or text (<a href="cmdText.html#cmdText">Section 2.3.9</a>)) are created in the current layer. Objects which are associated with other objects (such as tracks created by the <strong>Modify</strong> (<a href="cmdModify.html#cmdModify">Section 2.2.8</a>) or <strong>Join</strong> (<a href="cmdJoin.html#cmdJoin">Section 2.2.7</a>) commands) are created in the same layer as the associated object(s). +</p> +<p> +The <strong>Layers</strong> dialog allows you to change various attributes of each of the 99 possible <strong>layers</strong>. +</p> +<p> +Attributes associated with a layout are stored within the associated layout file and apply only to the layout that's open at the time of a change. It is possible to apply attributes from one layout file to another using the <strong>Load</strong> and <strong>Save</strong> buttons. +</p> +<p> +<img src="png.d/dlayers.png"> +</p> +<p> +The drop down list at the top of the dialog selects the <strong>Layer</strong> you are interested in. Frozen layers are preceeded by a <code>*</code>, Module layers are proceeded by a <code>m</code>, non-empty layers are preceded by a <code>+</code> and empty layers by a <code>-</code>. +</p> +<p> +The <strong>Name</strong> edit box contains the name of the <strong>Layer</strong>. This name is listed in the <strong>Current Layer</strong> drop down list on the <strong>Tool-bar</strong> (<a href="mainW.html#mainW">Section 3.1</a>). Also the <strong>Name</strong> is displayed as the balloon help for the corresponding <strong>Layer Button</strong>. +</p> +<p> +The <strong>Color</strong> button specifies the color of tracks if either of the two <strong>Color Layers</strong> (<a href="cmdDisplay.html#cmdDisplay">Section 2.10.3</a>) radio buttons on the <strong>Display</strong> dialog is checked and the <strong>Use Color</strong> button for this layer is checked. +</p> +<p> +The <strong>Visible</strong> check-box controls whether the <strong>Layer</strong> is drawn on the Main (<a href="mainW.html#mainW">Section 3.1</a>) window. +</p> +<p> +The <strong>Frozen</strong> check-box indicates that tracks in that <strong>Layer</strong> can not be modified or deleted. +</p> +<p> +The <strong>On Map</strong> check-box controls whether the <strong>Layer</strong> is drawn on the Map (<a href="cmdMap.html#cmdMap">Section 3.2.2</a>) window. +</p> +<p> +The <strong>Module</strong> check-box controls whether the <strong>Layer</strong> is selected/deselected and so moved or rotated as a group - this can be used to denote a track module in a modular layout - allowing the modules to be positioned as units. Objects in a Module Layer can not be individually modified. One way of getting a modules in is to build a library with <strong>Export</strong> and then <strong>Import As Module</strong> - this creates one layer per module, names it and sets the <strong>Module</strong> check-box. +</p> +<p> +The <strong>No Button</strong> check-box selects if the <strong>Layer</strong> has a button to hide/show it. You may choose not to have a button if the layer is empty or if it is a sub-layer controlled by another layer. +</p> +<p> +The <strong>Linked Layers</strong> text box can contain a semi-colon-delimited set of layer numbers that will be shown and hidden along with this layer when its show/hidden state is changed. A blank means no layers are linked. The layers can have buttons or not. +</p> +<p> +You cannot uncheck <strong>Visible</strong> or check <strong>Frozen</strong> for the <strong>Current Layer</strong>. +</p> +<p> +The <strong>Load Settings</strong> specifies a settings (.xset) filename in the XTrackCAD working directory that is loaded when this layer is made current. Only the values contained in the file will be set. If this name is blank the default values (all those in use when any layer that has no Load Settings file value was last used) will be reloaded (or retained). The dropbox contains all the names of files in that directory. +</p> +<p> +The <strong>Count</strong> field displays the number of objects in the selected Layer. +</p> +<p> +The <strong>Save</strong> button stores layer attributes in the <code>xtrkcad.ini</code> file so they may be loaded into an existing or new file. Once saved and unless reset to <em>XTrackCAD</em> <strong>Default</strong>, modified layer information is applied to each new file. +</p> +<p> +The <strong>Load</strong> button reads layer attributes from the <code>xtrkcad.ini</code> file then applies it to each layer of the current layout file. +</p> +<p> +The <strong>Defaults</strong> button restores layer attributes to default <em>XTrackCAD</em> settings. +</p> +<p> +The bottom of the dialog contains the <strong>Number of Layer Buttons</strong> integer edit box. This controls the number of <strong>Layer Buttons</strong> displayed on the <strong>Tool-bar</strong> (<a href="mainW.html#mainW">Section 3.1</a>). These buttons make it easy to switch between layers. The maximum number of <strong>Layer Buttons</strong> that can be displayed is 99. Layers with "no-button" set do not count towards the Number of Layer Buttons. +</p> +<p> +<img src="png.d/blayer.png"> +</p> +<p> +The <strong>Layer Buttons</strong> on the Tool-bar (<a href="mainW.html#mainW">Section 3.1</a>) control which layer is the <strong>current Layer</strong> and which <strong>Layers</strong> are displayed on the Main Canvas. These buttons are a short cut for the <strong>Visible</strong> check-box on the <strong>Layers</strong> dialog for the corresponding layer. +</p> +<p> +The current layer is selected by picking a value from the drop down layer list. If the Layer you've selected was not visible, it will be shown. +</p> +<p> +You can hide (or show if not visible) the different layers by pushing one of the <strong>Layer Buttons</strong> on the Tool-bar (if you have configured the tool-bar (<a href="toolbarM.html#toolbarM">Section 2.12.3</a>) to show the Layer buttons). If a layer is not visible then the corresponding layer button will be raised. The active or current layer cannot be hidden. +</p> +<p> +The color of each layer button shows the color that will be used to draw tracks or draw objects in that layer, if you have selected the <strong>Color Layers</strong> (<a href="cmdDisplay.html#cmdDisplay">Section 2.10.3</a>) on the <strong>Display</strong> dialog. The <strong>Use Color</strong> button allows this layer to opt in or out - which can be usefu if you want to color other layers but a layer contains pre-colored objects (like Structures or Scenery). +</p> +<p> +Any selected objects are unselected when the Layer is set to not visible. If a layer is not visible, you cannot select objects in the Layer. It is as if the objects do not exist until you show the layer again. +</p> +<p> +The <strong>Move To Current Layer</strong> command on Edit menu (<a href="editM.html#editM">Section 2.4</a>) will move all selected (<a href="cmdSelect.html#cmdSelect">Section 2.2.16</a>) tracks to the current Layer. +</p> +<p> +Objects are drawn on the map window, if the Layer they are on has <strong>On Map</strong> checked. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Parts List </title> +<link rel="previous" href="cmdLayer.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdPricelist.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdEnum"></a>2.9.6 <a name="i0"></a>Parts List <a name="i1"></a></h1> +<p> +The <strong>Parts List</strong> command produces a list of all selected (<a href="cmdSelect.html#cmdSelect">Section 2.2.16</a>) turnouts, sectional track and bench-work. It also computes total length of selected flex-track. +</p> +<p> +If no objects are selected, all objects are enumerated. +</p> +<p> +<img src="png.d/partslist.png"> +</p> +<p> +The <strong>Save As...</strong> button opens a <em>File Save</em> dialog window that's used to name and save the parts list to a file. +</p> +<p> +The <strong>Print</strong> button opens the <em>Print</em> dialog which is used to facilitate printing of the parts list. +</p> +<p> +The <strong>Close</strong> button terminates the <strong>Parts List</strong> command. +</p> +<p> +The <strong>Parts List</strong> dialog will list pricing for selected objects if the <em>Prices</em> check box is checked. Prices are set using the Price List (<a href="cmdPricelist.html#cmdPricelist">Section 2.9.7</a>) dialog. +</p> +<p> +The <strong>Parts List</strong> dialog will list the index numbers of each type of named track in a comma delimited list on a new line if the <em>Indexes</em> check box is checked. This list can be used in the Select By Index (<a href="cmdSelectIndex.html#cmdSelectIndex">Section 2.4.1</a>) command. +</p> +<p> +Hint: you can use the <strong>Parts List</strong> command to measure the length of selected flex-track. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Price List</title> +<link rel="previous" href="cmdEnum.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdTrain.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdPricelist"></a>2.9.7 <a name="i0"></a>Price List</h1> +<p> +The <strong>Price List</strong> dialog allows entry of prices for Turnouts, Sectional Track and Structures. Only those objects from loaded Parameter Files (<a href="cmdPrmfile.html#cmdPrmfile">Section 2.5.7</a>) or <em>Custom Designs</em> for the current Scale (<a href="cmdLayout.html#cmdLayout">Section 2.10.6</a>) are listed. +</p> +<p> +<img src="png.d/pricelist.png"> +</p> +<p> +The price of a selected object can be changed in the <em>Cost</em> edit box that's located above the "Price" column. +</p> +<p> +The price of a length of <em>Flex-Track</em> for the current Scale (<a href="cmdLayout.html#cmdLayout">Section 2.10.6</a>) is listed at the bottom of the dialog. You can specify the <em>Length</em> in <em>Inches</em> or <em>Centimeters</em>. To specify the price for other <em>Scales</em> change Scale (<a href="cmdLayout.html#cmdLayout">Section 2.10.6</a>) on the Layout (<a href="cmdLayout.html#cmdLayout">Section 2.10.6</a>) window. +</p> +<p> +The Parts List (<a href="cmdEnum.html#cmdEnum">Section 2.9.6</a>) dialog lists prices for selected objects if the <em>Prices</em> check box on the dialog window is selected. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Train Mode </title> +<link rel="previous" href="cmdPricelist.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdTurnoutNew.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdTrain"></a>2.9.8 <a name="i0"></a>Train Mode <a name="i1"></a></h1> +<p> +<img src="png.d/btrain.png"> The <strong>Train</strong> command lets you place and run Trains on the layout. +</p> +<p> +<a name="i2"></a>During this command, the Tool Bar and Hot Bar are changed. Most of the Tool Bar buttons are replaced by the <em>Go/Stop</em> and <em>Exit</em> buttons. The <em>Go/Stop</em> button toggles between Pausing all Trains and allowing Trains to Run. The <em>Exit</em> button terminates the Train Simulation and returns to Layout Design mode. The Hot Bar becomes the <strong>Shelf</strong>. +</p> +<p> +<img src="png.d/trainbar.png"> +</p> +<p> + +</p> +<dl><dt> +<em>Selecting New Cars</em> +</dt> +<dd> +The <strong>Shelf</strong> contains the Cars and Locomotives which have not been placed on the Layout. Cars are created and managed using the Car Inventory (<a href="cmdCarinv.html#cmdCarinv">Section 2.9.1</a>) dialog. +</dd> +</dl> +<p> + +</p> +<dl><dd> +Each item on the <strong>Shelf</strong> can represent a group of Cars. Cars can be grouped by Prototype, Manufacturer and/or Part Number. They can also be listed as individual Car Items. This grouping is controlled by <em>Car Labels</em> Drop Down List on the Display (<a href="cmdDisplay.html#cmdDisplay">Section 2.10.3</a>) dialog. +</dd> +</dl> +<p> + +</p> +<dl><dd> +To place a Car, select it from the <strong>Shelf</strong>. If the <strong>Shelf</strong> is displaying Cars in groups (and not as individual Car Items) then a Drop Down List is displayed on the Status Bar (<a href="mainW.html#mainW">Section 3.1</a>) containing the individual Car Items in that group. +</dd> +</dl> +<p> + +</p> +<dl><dd> +If you are not displaying the <strong>Shelf</strong>, then the <em>New Car</em> button (<img src="png.d/bnewcar.png">) will be shown on the Tool Bar. Pressing this button will display the Drop Down List on the Status Bar (<a href="mainW.html#mainW">Section 3.1</a>) containing all of your Car Items that have not yet been placed on the layout. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<img src="png.d/trainsimulator.png"> +</dd> +</dl> +<p> + +</p> +<dl><dd> +<img src="png.d/statusbartrain.png"> +</dd> +</dl> +<p> + +</p> +<dl><dd> +<img src="png.d/carlist.png"> +</dd> +</dl> +<p> + +</p> +<dl><dt> +<em>Placing Cars</em> +</dt> +<dd> +Once you have selected a new Car, or have selected an existing Car on the Layout, you can position it by using the mouse to drag it around the Layout. If the Car is coupled to other Cars then the whole set of Cars is moved. If you place the Car on a Track, that Car (and the other coupled Cars) will be aligned along the track. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Note:</strong> If you move the tracks but not the cars (or vice-versa) using the Move (<a href="cmdMove.html#cmdMove">Section 2.2.9</a>) or Rotate (<a href="cmdRotate.html#cmdRotate">Section 2.2.15</a>) commands the cars will not remain attached to the tracks. If the cars are moved close to a track, then they will be aligned when the <em>Train Simulation</em> command is next invoked. +</dd> +</dl> +<p> + +</p> +<dl><dt> +<em>Coupling Cars</em> +</dt> +<dd> +If a Car is moved along a track to another Car then the Cars will be coupled together. +</dd> +</dl> +<p> + +</p> +<dl><dt> +<em>Uncoupling Cars</em> +</dt> +<dd> +To uncouple Cars, Right-Click between the Cars then select <em>Uncouple</em> from the pop-up menu. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<img src="png.d/mtrainmanagement.png"> +</dd> +</dl> +<p> + +</p> +<dl><dt> +<em>Change Train or Car Orientation</em> +</dt> +<dd> +The orientation of a Train or Car can be reversed by Right-Click over the appropriate object then selecting either <em>Flip Train</em> or <em>Flip Car</em> from the pop-up menu. +</dd> +</dl> +<p> + +</p> +<dl><dt> +<em>Remove Train or Car From Layout</em> +</dt> +<dd> +To remove a Train or Car from the layout, Right-Click over the appropriate object then select either <em>Remove Train</em> or <em>Remove Car</em> from the pop-up menu. +</dd> +</dl> +<p> + +</p> +<dl><dt> +<em>Change Reporting number of Car on Layout</em> +</dt> +<dd> +To change the reporting number, Right-Click over the Car and then select <em>Describe</em> and update the field. This value will be shown in the car if Labels are shown and in the <em>Train Control</em> Window. +</dd> +</dl> +<p> + +</p> +<dl><dt> +<em>Trains</em> +</dt> +<dd> +A Train consists of one or more Locomotives coupled to other Cars. One Locomotive will be the <em>MU Master</em> for the Train. The <em>MU Master</em> can be changed by Right-Clicking on a Locomotive and selecting <em>MU Master</em> from the pop-up menu. The <em>MU Master</em> is drawn with a solid Yellow head light indicating the direction is moving. If a Train is split by uncoupling between Locomotives, then two Trains will be created, each with their own <em>MU Master</em>. +</dd> +</dl> +<p> + +</p> +<dl><dt> +<em>Train Control</em> +</dt> +<dd> +<img src="png.d/trainctrl.png"> +</dd> +</dl> +<p> + +</p> +<dl><dd> +The <em>Train Control</em> dialog is used to set the speed and direction of Trains. The dialog contains a list of Trains (listed by their <em>MU Master</em> Locomotive reporting number). Before each Train on the list is either a Red circle (indicating the Train is stopped) or a Green circle (indicating the Train is moving). +</dd> +</dl> +<p> + +</p> +<dl><dd> +Any number of Trains can be running, although it might be difficult to keep track of more than a few. +</dd> +</dl> +<p> + +</p> +<dl><dd> +For the selected Train, the Train Control dialog lists +<dl><dd> +Train status: indicating that the Train is moving, is paused or the reason if the Train is stopped. +</dd> +</dl> +<p> + +</p> +<dl><dd> +The position of the Train +</dd> +</dl> +<p> + +</p> +<dl><dd> +A slider which controls the speed of the Train in Scale Miles-Per-Hour or Kilometers-Per-Hour. +</dd> +</dl> +<p> + +</p> +<dl><dd> +The Odometer which measures the total distance travelled by the train, which can be reset by pressing the <em>0</em> button. +</dd> +</dl> +<p> + +</p> +<dl><dd> +The <em>Find</em> button which positions the Main Window (<a href="mainW.html#mainW">Section 3.1</a>) to show the Train. If the Trains on a track that's hidden and Hide Trains on Hidden Track (<a href="cmdDisplay.html#cmdDisplay">Section 2.10.3</a>) is <em>Enabled</em> then the Train will be made visible until the next time it moves. +</dd> +</dl> +<p> + +</p> +<dl><dd> +The <em>Follow</em> toggle button which causes the Main Window (<a href="mainW.html#mainW">Section 3.1</a>) to follow the Train as it moves. The <em>Follow</em> toggle can only be set on one Train at a time, and it is cleared if you press the <em>Find</em> button or otherwise manually move the main canvas. +</dd> +</dl> +<p> + +</p> +<dl><dd> +The <em>Auto Reverse</em> toggle button which causes the Train to change direction when it hits the end of a track. +</dd> +</dl> +<p> + +</p> +<dl><dd> +The Direction radio button group which controls the direction (<em>Forward</em> or <em>Reverse</em>) of the Train. +</dd> +</dl> +<p> + +</p> +<dl><dd> +The <em>Stop</em> button which sets the Trains speed to 0. +</dd> +</dl> + +</dd> +</dl> +<p> + +</p> +<dl><dt> +<em>Train Operation</em> +</dt> +<dd> +Once a Train is moving, it will continue to move until it is Stopped manually, hits the end of track or an open Turnout. If the Train 'runs into' other Cars, those Cars will be coupled to the Train. If Trains speed is faster than the Max Coupling Speed (<a href="cmdPref.html#cmdPref">Section 2.10.7</a>) then the Train will crash and must be manually moved back onto the track. +</dd> +</dl> +<p> + +</p> +<dl><dd> +If two Trains are coupled, one of the two <em>MU Masters</em> will be chosen as the <em>MU Master</em> for the combined Train. +</dd> +</dl> +<p> + +</p> +<dl><dd> +The motion of all Trains can be Paused by clicking the <em>Go/Stop</em> button on the Main Window Tool Bar. Pressing the <em>Escape</em> key has the same effect as clicking on the <em>Stop</em> button. This allows you set Turnout positions or make other changes. When Train command starts, the <em>Go/Stop</em> button is in the <em>Stop</em> position and must be clicked before Trains move. +</dd> +</dl> +<p> + +</p> +<dl><dt> +<em>Turnouts and Turntables</em> +</dt> +<dd> +Turnout positions are indicated by Red lines connecting the endpoints on the route through the Turnout. Trains will follow this route through the Turnout. If you <em>Shift+Left-Click</em> on the Turnout, the next position will used and Red line changed to indicate the new position. +</dd> +</dl> +<p> + +</p> +<dl><dd> +Turntables can be turned by using <em>Shift+Left-Click</em> on the endpoint you want the Turntable bridge to move to. If you click on the Turntable where there is no endpoint, the Turntable will turn to the next endpoint beyond that point in the direction of the click relative to the nearest end of the turntable bridge. To turn the Turntable 180°, <em>Shift+Left-Click</em> on the current endpoint again. +</dd> +</dl> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Turnout Designer</title> +<link rel="previous" href="cmdTrain.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdRefreshSpecial.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdTurnoutNew"></a>2.9.9 <a name="i0"></a>Turnout Designer</h1> +<p> +The <strong>Turnout Designer</strong> allows you to define new turnouts and sectional track pieces. +</p> +<p> +<img src="png.d/mmanageturnoutdesign.png"> +</p> +<p> +The Turnout Designer sub-menu is pictured above. As demonstrated by the sub-menu a number of different dialogs are available for creation of custom turnout and sectional track components. New turnouts and sectional track is added to Custom Management (<a href="cmdCustmgm.html#cmdCustmgm">Section 2.9.2</a>) and Turnout Manager (<a href="cmdNewFixedTrack.html#cmdNewFixedTrack">Section 2.1.8</a>) using the <strong>Turnout Designer</strong>. +</p> +<p> +The follow dialog is for a regular turnout. +</p> +<p> +<img src="png.d/turndes.png"> +</p> +<p> +Each dialog shows a diagram of the turnout and has fields to enter dimensions. The dimensions should be as accurate as possible. The various types of dimensions are: +</p> +<dl><dd> +<strong>Length</strong> - measured from the base of the turnout to the centerline at the end of the turnout. Length is measured parallel to the centerline of the straight leg of the turnout. For track that ends on a curve (such as the curved leg of a regular turnout) measure the distance from the base to each rail and average the values. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Offset</strong> - measured from the centerline of the straight leg of the turnout to the centerline of the track at the end of the turnout. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Angle</strong> - angle at the end of turnout to the centerline of the straight leg of the turnout. This angle may not be the same as the <em>Frog</em> angle of the turnout if the rails curve past the <em>Frog</em>. The <strong>Frog Number|Degrees</strong> Radio button group controls whether the value is expressed in Frog Number or Degrees. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Manufacturer</strong> - name of the Manufacturer +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Description</strong> - description of the turnout including size and rail code number, e.g., 'Left Hand #4'. This information is shown when a place the mouse pointer over the respective symbol on th <strong>Tool-bar</strong>. Therefor it should be made sure that the data entered here are helpful in finding the correct turnout. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>#</strong> - part number, e.g., '999-123'. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Roadbed Width</strong> - if greater than the track gauge then lines are drawn along the edges of the turnout to represent the attached roadbed available on some types of sectional track and turnouts. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Line Width</strong> - the width of the roadbed lines, measured in pixels when the layout drawing scale (<a href="viewM.html#viewM">Section 2.12</a>) is 1:1. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Color</strong> - color of the roadbed lines. +</dd> +</dl> +<p> + +</p> +<p> +The rail height (<em>Code</em>) can be added to the <strong>Manufacturer</strong>, e.g., Peco-55, or the <strong>Description</strong>, e.g., Medium Right, Code 55. +</p> +<p> +The scale is the current scale from the <strong>Scale Drop Down List</strong> on the <strong>Layout</strong> dialog (<a href="cmdLayout.html#cmdLayout">Section 2.10.6</a>). +</p> +<p> +<strong>Manufacturer</strong>, <strong>Description</strong> and <strong>Part Number (#)</strong> comprise the title of the turnout. These values are used in the <strong>Turnout Selection dialog</strong> (<a href="cmdNewFixedTrack.html#cmdNewFixedTrack">Section 2.1.8</a>) and the <strong>Parts List</strong> (<a href="cmdEnum.html#cmdEnum">Section 2.9.6</a>). For regular and curved turnouts there are separate <strong>Descriptions</strong> and <strong>Part Numbers</strong> for the right and left hand turnouts. +</p> +<p> +The <strong>Print</strong> button prints a full size diagram of the turnout. You can use this to check your dimensions and make any required changes. You should expect to make several printouts as you refine your dimensions. +</p> +<p> +The <strong>OK</strong> button completes the design. The new turnout is added to the list in the <strong>Turnout Selection</strong> dialog. The turnout data is saved in the <code>xtrkcad.cus</code> (<a href="directories.html#directories">Section 1.9</a>) file for the next time you use <em>XTrackCAD</em>. Please consider contributing this information for others to use via the on-line addresses. You can change the Parameters or Title of existing designs by using the <strong>Custom Management</strong> (<a href="cmdCustmgm.html#cmdCustmgm">Section 2.9.2</a>) dialog. +</p> +<p> +The <strong>Cancel</strong> button removes the <strong>Turnout Designer</strong> dialog. +</p> +<p> +<em>Creating Turnout Designs</em> +</p> +<ul><li> +It is best to start by marking the endpoints of the turnout on a piece of paper. Extend the curved leg of the turnout (try attaching a straight sectional track) and measure the angle. Frog numbers are easiest to calculate. +</li> +</ul> +<p> + +</p> +<ul><li> +Enter your data and press <strong>Print</strong>, if you have an accurate printer. Check the dimensions of the turnout against the printout and make adjustments as necessary. Concentrate on the lengths and offsets first, then adjust the angles. +</li> +</ul> +<p> + +</p> +<ul><li> +The resulting turnout is an approximation. In particular the curves will not be correct, but this is not important for placing turnouts. +</li> +</ul> +<p> + +</p> +<ul><li> +The new <a name="i1"></a>Cornu Turnouts allow you to build turnouts that have curved ends. The dialogs include radius information that can be set to zero for a straight end. The turnouts will be composed of simple curves and tracks and when extended the end radius will be used. +</li> +<li> +The Group (<a href="cmdGroup.html#cmdGroup">Section 2.9.4</a>) command can be used to add cosmetic details to <strong>Turnout</strong> definitions. +</li> +</ul> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Update Turnouts and Structures</title> +<link rel="previous" href="cmdTurnoutNew.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdUngroup.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdRefreshSpecial"></a>2.9.10 <a name="i0"></a>Update Turnouts and Structures</h1> +<p> +This command updates (or refreshes) selected turnouts, sectional tracks and structures on your layout with the current definitions from the loaded parameter files (<a href="cmdPrmfile.html#cmdPrmfile">Section 2.5.7</a>). Each selected object that is found in a parameter file is updated with the current definition. +</p> +<p> +If an object can be found and if a new track definition fits in the same footprint, (i.e., has the same number of endpoints and all the endpoints have the same position and angle) then a dialog is displayed which contains suitable definitions that you can choose from. You can <strong>Skip</strong> the current object or <strong>Cancel</strong> to skip all the remaining objects. +</p> +<p> +Otherwise the update fails and must be done manually using <strong>Delete</strong> and <strong>Add</strong>. +</p> +<p> +If an object has been updated then it is unselected, otherwise it will remain selected at the end of this command. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Ungroup</title> +<link rel="previous" href="cmdRefreshSpecial.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="optionM.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdUngroup"></a>2.9.11 <a name="i0"></a>Ungroup</h1> +<p> +<strong>Ungroup</strong> allows existing definitions to be modified and the resulting objects recombined with the <strong>Group</strong> (<a href="cmdGroup.html#cmdGroup">Section 2.9.4</a>) command to update the definition. Turnouts are composed of individual straight and curved segments. Segments that form the points (<a href="generalTerms.html#generalTerms">Section B.2</a>) of the turnout remain combined as an <em>Ungrouped Turnout</em>, and the other segments are replaced by straight and curved tracks. +</p> +<p> +One-ended Turnouts (AKA Bumpers) are converted to Staight tracks by <strong>Ungroup</strong>. These can be converted back to a Bumper by manually editting the <strong>Grouped</strong> definition and removing the unwanted End-Point by deleting the correspnding <strong>E</strong> line. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Options Menu</title> +<link rel="previous" href="cmdUngroup.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdRgbcolor.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="optionM"></a>2.10 <a name="i0"></a>Options Menu</h1> +<p> +<img src="png.d/moptions.png"> +</p> +<p> +The <strong>Options Menu</strong> shows commands to change configuration options. +</p> +<dl><dd> +<strong>Colors</strong> - Displays the Colors (<a href="cmdRgbcolor.html#cmdRgbcolor">Section 2.10.1</a>) dialog. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Command</strong> - Displays the Command Options (<a href="cmdCmdopt.html#cmdCmdopt">Section 2.10.2</a>) dialog. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Display</strong> - Displays the Display (<a href="cmdDisplay.html#cmdDisplay">Section 2.10.3</a>) dialog. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Easement</strong> - Displays the easement (<a href="cmdEasement.html#cmdEasement">Section 2.10.4</a>) dialog which controls how easements (spiral transition curves) are used to join tracks. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Fonts</strong> - Displays the font selection (<a href="fontSelW.html#fontSelW">Section 2.10.5</a>) dialog which selects the font used by the text (<a href="cmdText.html#cmdText">Section 2.3.9</a>) command. This command is only available on UNIX based systems. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Layout</strong> - Displays the layout (<a href="cmdLayout.html#cmdLayout">Section 2.10.6</a>) dialog. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Preferences</strong> - Displays the Preferences (<a href="cmdPref.html#cmdPref">Section 2.10.7</a>) dialog. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Sticky</strong> - Displays the Sticky Commands (<a href="cmdSticky.html#cmdSticky">Section 2.10.8</a>) dialog. +</dd> +</dl> +<hr> +<ul> +<li><a href="cmdRgbcolor.html#cmdRgbcolor">2.10.1 Colors Dialog</a></li> +<li><a href="cmdCmdopt.html#cmdCmdopt">2.10.2 Command Option Dialog</a></li> +<li><a href="cmdDisplay.html#cmdDisplay">2.10.3 Display Dialog</a></li> +<li><a href="cmdEasement.html#cmdEasement">2.10.4 Easements</a></li> +<ul> +<li><a href="EasementsCornu.html#EasementsCornu">2.10.4.1 Cornu Easements</a></li> +<li><a href="EasementsTraditional.html#EasementsTraditional">2.10.4.2 Easements with Fixed Sharpness</a></li> +<li><a href="EasementsSectional.html#EasementsSectional">2.10.4.3 Easements and Sectional Track</a></li> +</ul> +<li><a href="fontSelW.html#fontSelW">2.10.5 Font Selection</a></li> +<li><a href="cmdLayout.html#cmdLayout">2.10.6 Layout Dialog</a></li> +<li><a href="cmdPref.html#cmdPref">2.10.7 Preferences Dialog</a></li> +<li><a href="cmdSticky.html#cmdSticky">2.10.8 Sticky Dialog</a></li> +</ul> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Colors Dialog</title> +<link rel="previous" href="optionM.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdCmdopt.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdRgbcolor"></a>2.10.1 <a name="i0"></a>Colors Dialog</h1> +<p> +The <strong>Colors</strong> dialog is invoked from the Options (<a href="optionM.html#optionM">Section 2.10</a>) menu +</p> +<p> +<img src="png.d/colorw.png"> +</p> +<p> +The <strong>Colors</strong> dialog controls the color that various objects are drawn. +</p> +<dl><dd> +<strong>Border</strong> - Sets color of Rulers, Room Boundaries and Table Edges. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Exception Track</strong> - Sets color of <em>Exceptional Tracks</em> (<a href="cmdLayout.html#cmdLayout">Section 2.10.6</a>). Those which exceed the specified grade or are have a radius smaller than the minimum set. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Marker</strong> - Sets color of short lines drawn on the Ruler of the Main (<a href="mainW.html#mainW">Section 3.1</a>) window to indicate cursor position. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Normal Tracks</strong> - Sets color of normal track. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Primary Axis</strong> - Sets color of the large cross displayed when positioning the <strong>Snap Grid</strong> (<a href="cmdGrid.html#cmdGrid">Section 2.12.2</a>) or the <strong>Print Grid</strong> (<a href="cmdPrint.html#cmdPrint">Section 2.5.9</a>). +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Profile Path</strong> - color of the path when using the <strong>Profile</strong> (<a href="cmdProfile.html#cmdProfile">Section 2.2.12</a>) command. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Secondary Axis</strong> - Sets color of the large cross displayed when positioning the <strong>Snap Grid</strong> (<a href="cmdGrid.html#cmdGrid">Section 2.12.2</a>) or the <strong>Print Grid</strong> (<a href="cmdPrint.html#cmdPrint">Section 2.5.9</a>). +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Selected Tracks</strong> - Sets color of Selected track. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Snap Grid</strong> - the Grid displayed by the <strong>Snap Grid</strong> (<a href="cmdGrid.html#cmdGrid">Section 2.12.2</a>) dialog. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Track Ties</strong> - color of ties (if drawn). +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Bridge Base</strong> - color of Bridge fill between the parapets. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Track Roadbed</strong> - color of Roadbed fill under the track. +</dd> +</dl> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Command Option Dialog</title> +<link rel="previous" href="cmdRgbcolor.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdDisplay.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdCmdopt"></a>2.10.2 <a name="i0"></a>Command Option Dialog</h1> +<p> +The <strong>Command Option</strong> dialog is invoked from the Options (<a href="optionM.html#optionM">Section 2.10</a>) menu +</p> +<p> +<img src="png.d/cmdopt.png"> +</p> +<p> +The <strong>Command Option</strong> dialog contains items which control the behavior of some commands. +</p> +<dl><dd> +<strong>Default Command</strong> - selects the <strong>Properties</strong> (<a href="cmdDescribe.html#cmdDescribe">Section 2.2.13</a>) or <strong>Select</strong> (<a href="cmdSelect.html#cmdSelect">Section 2.2.16</a>) as the default command which is invoked when any other command (if not <strong>Sticky</strong> (<a href="cmdSticky.html#cmdSticky">Section 2.10.8</a>)) is canceled or completed. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<em>Right-Click</em> - will either display a pop-up menu of available commands or command-specific options depending on whether the <em>Shift</em> key is being held down or not. This option allows you to choose which operation occurs. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<em>Select-Mode</em> - will either (a) only select the current item unless Ctrl is added or (b) will add the current item to the selection unless Ctrl is added in which case it will only select this item. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<em>Select-Zero</em> - if selected will perform <strong>Deselect All</strong> if the selection is not on an object. +</dd> +</dl> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Display Dialog</title> +<link rel="previous" href="cmdCmdopt.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdEasement.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdDisplay"></a>2.10.3 <a name="i0"></a>Display Dialog</h1> +<p> +The <strong>Display</strong> dialog is invoked from the Options (<a href="optionM.html#optionM">Section 2.10</a>) menu +</p> +<p> +<img src="png.d/displayopt.png"> +</p> +<p> +The <strong>Display</strong> dialog contains items which control the display of objects on the Main window. +</p> +<dl><dd> +<strong>Auto Pan</strong> - if enabled, dragging near the edge of the Main Canvas (<a href="mainW.html#mainW">Section 3.1</a>) will cause the canvas to move to follow the mouse. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Car Labels</strong> - controls the grouping and display of <strong>Cars</strong> on the <strong>Hot Bar</strong> (<a href="cmdHotBar.html#cmdHotBar">Section 2.7</a>) during the <strong>Train</strong> (<a href="cmdTrain.html#cmdTrain">Section 2.9.8</a>) command. This can be a combination of <strong>Prototype</strong>, <strong>Manufacturer</strong>, <strong>Part Number</strong> and <strong>Item</strong>. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Color Tracks</strong> - when set to layers, tracks are drawn with color of the layer (<a href="cmdLayer.html#cmdLayer">Section 2.9.5</a>) they belong to and not the normal track color. This can be disabled in the Layer dialog for each Layer by unchecking the <strong>Use Color</strong> checkbox. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Color Draws</strong> - when set to layers, non-tracks (lines, table edges and structures) are drawn with color of the layer (<a href="cmdLayer.html#cmdLayer">Section 2.9.5</a>) they belong to rather than based on thier own object setting. This can be disabled in the Layer dialog for each Layer by unchecking the <strong>Use Color</strong> checkbox. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Constrain Drawing Area to Room Boundaries</strong> - when Zooming and moving the Main Canvas (<a href="mainW.html#mainW">Section 3.1</a>) may show areas beyond the boundaries of the room. Setting this option constrains the Main Canvas to minimize these areas (the <strong>grey</strong> area). +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Dont Hide System Cursor</strong> - when XTrackCAD substitutes a specialized cursor to show actions that will occur (or are occuring) it will normallly hide the System Cursor. This option suppresses this behaviour and leaves the system cursor in place. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Draw EndPts</strong> - when to draw endpoints between connected track: never, only for turnouts or for all tracks. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Draw Unconnected EndPts</strong> - how to draw unconnected endpoints; normally, with a thick line or with a thick line in the exception color. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Draw Ties</strong> - how to draw ties under the rails when the drawing Scale is smaller than half of the <strong>Two Rail Scale</strong>. Note that <a href="cmdTies.html#cmdTies">Section 2.4.6</a> can be used to hide ties for selected tracks. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Draw Centers</strong> - enable or disable drawing of center markings (ie. crosshairs) for curved track. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Draw Tunnel</strong> - how to draw hidden tracks (<a href="cmdTunnel.html#cmdTunnel">Section 2.4.5</a>), either not at all, as dashed lines or as normal solid lines (which might be faster). +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Hide Trains On Hidden Track</strong> - controls whether trains (<a href="cmdTrain.html#cmdTrain">Section 2.9.8</a>) on invisible layers (<a href="cmdLayer.html#cmdLayer">Section 2.9.5</a>) or hidden tracks (<a href="cmdTunnel.html#cmdTunnel">Section 2.4.5</a>) (if hidden tracks are not drawn) are displayed. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Hot Bar Labels</strong> - controls the format of titles for objects on the <strong>Hot Bar</strong> (<a href="cmdHotBar.html#cmdHotBar">Section 2.7</a>). +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Label Enable</strong> - individual control over whether to display various types of labels. You may want to turn some of these off if your layout is too cluttered. +<p> + +</p> +<ul><li> +<em>Cars</em> - Reporting mark labels on cars - the content shown on the Cars label is either the Repmarks (if the Rep Number is set), or the car index number (with a "#" before it). See the Car Part dialog <a href="carpart.html#carpart">Section 2.9.1.2</a>. +</li> +<li> +<em>EndPt Elevations</em> - Elevation markers attached to endpoints. +</li> +<li> +<em>Lengths</em> - Length of flex-track attached to ends of turnouts all the way to the next turnout. +</li> +<li> +<em>Track Descriptions</em> - Title of each turnout and sectional track, optional details of each piece of Flexible Track. These can be shown or hidden using the Move Description <a href="cmdMoveLabel.html#cmdMoveLabel">Section 2.2.10</a> command. +</li> +<li> +<em>Track Elevations</em> - Computed elevations at the center of each track. +</li> +</ul> + +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Label Font Size</strong> - controls font size for Labels on layout. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Layout Labels</strong> - controls the format of titles for Turnouts and Structures displayed on the Layout. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Label Scale</strong> - the program will draw labels only when the drawing Scale is smaller or equal to this value. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>List Labels</strong> - controls the format of titles for turnouts and structures displayed in lists (such as the <strong>Parts List</strong> (<a href="cmdEnum.html#cmdEnum">Section 2.9.6</a>)). +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Live Map</strong> - if checked then the Main Window (<a href="mainW.html#mainW">Section 3.1</a>) will be updated as you drag on the <strong>Map Window</strong> (<a href="cmdMap.html#cmdMap">Section 3.2.2</a>). Note that this can be slow. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Map Scale</strong> - scale of the Map (<a href="cmdMap.html#cmdMap">Section 3.2.2</a>) window. Increase this value to make the <strong>Map</strong> window smaller when working with large layouts. <strong>Note:</strong> you cannot make the <strong>Map</strong> window larger than the screen. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Train Update Delay</strong> - number of milliseconds between updates in the <strong>Train Simulation</strong> (<a href="cmdTrain.html#cmdTrain">Section 2.9.8</a>) mode. A lower value will generate a smoother display but reduces system responsiveness. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Two Rail Scale</strong> - draw tracks using two lines when the drawing Scale is smaller than this value. +</dd> +</dl> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Easements</title> +<link rel="previous" href="cmdDisplay.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="EasementsCornu.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdEasement"></a>2.10.4 <a name="i0"></a>Easements</h1> +<p> +Easements are special sections of gradually curving track used to connect straight and curved tracks (or two curved tracks). Easements reduce the effects of sudden changes in track curves which can cause jerky motion and derailments. +</p> +<p> +Easements can be created every time you <strong>Join</strong> (<a href="cmdJoin.html#cmdJoin">Section 2.2.7</a>) tracks, <strong>Extend</strong> (<a href="extendTrack.html#extendTrack">Section 2.2.8.6</a>) a track or create a <strong>Tangent</strong> (<a href="createTangent.html#createTangent">Section 2.2.8.4</a>) track. +</p> +<p> +When using easements, an error message will be generated if tracks have a radius that is too small or are too short for the transition curve. +</p> +<p> +The <strong>Easement</strong> dialog is invoked from the Options (<a href="optionM.html#optionM">Section 2.10</a>) menu. +</p> +<dl><dd> +<img src="png.d/easew.png"> +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Value</strong> - allows fine tuning of the easement parameters (restricted to values >= 0.5). +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>R</strong> - minimum radius of the curved track. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>X</strong> - offset between a straight and curved track. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>L</strong> - length of the transition track. +</dd> +</dl> +<p> + +</p> +<dl><dd> +Radio button group with <strong>None</strong>, <strong>Sharp</strong>, <strong>Normal</strong>, <strong>Broad</strong> and <strong>Cornu</strong>. Corresponding <strong>Value</strong>s for these buttons are 0, 0.5, 1.0, 2.0 and -1.0. Select <strong>None</strong> to turn easements off. +</dd> +</dl> +<p> +For traditional fixed sharpness easements see <a href="EasementsTraditional.html#EasementsTraditional">section 2.10.4.2</a>, for Cornu Easements see <a href="EasementsCornu.html#EasementsCornu">section 2.10.4.1</a>. +</p> +<ul> +<li><a href="EasementsCornu.html#EasementsCornu">2.10.4.1 Cornu Easements</a></li> +<li><a href="EasementsTraditional.html#EasementsTraditional">2.10.4.2 Easements with Fixed Sharpness</a></li> +<li><a href="EasementsSectional.html#EasementsSectional">2.10.4.3 Easements and Sectional Track</a></li> +</ul> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Cornu Easements</title> +<link rel="previous" href="cmdEasement.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="EasementsTraditional.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="EasementsCornu"></a>2.10.4.1 <a name="i0"></a>Cornu Easements</h1> +<p> +The Cornu Easements work in a different way to the other easements. They use all the space available to minimize sharpness, so you can control the sharpness for each curve you draw by the distance apart, radius and angle of the two end points. +</p> +<p> +The Cornu is a mathematical curve that has the property that the curvature (inverse of the radius) varies linearly along its length. Using an open-source Cornu library written by Dr Raph Levin, we can calculate an Cornu easment to suit the end conditions of radius, curve center, angle and position. A Cornu easement can be constructed between two tracks by using the values of these parameters. +</p> +<p> +To draw an cornu easement see <a href="joinCornu.html#joinCornu">section 2.2.7.4</a>, to Modify it afterwards see <a href="chgCornu.html#chgCornu">section 2.2.8.8</a>. +</p> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Easements with Fixed Sharpness</title> +<link rel="previous" href="EasementsCornu.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="EasementsSectional.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="EasementsTraditional"></a>2.10.4.2 <a name="i0"></a>Easements with Fixed Sharpness</h1> +<p> +The values <strong>R</strong>, <strong>X</strong> and <strong>L</strong> are read-only. They are set using the radio buttons or the <strong>Value</strong> field which can be set to 0 (No Easment) or between 0.21 (sharpest Easement) 100 (broadest Easment). +</p> +<p> +These values indicate the worst case of joining a straight track with a curve of radius <strong>R</strong>. The two tracks are separated by the offset <strong>X</strong> while the easement curve extends for <strong>L/2</strong> inches or centimeters to each side of the endpoints. +</p> +<p> +The formula used to draw non-Cornu easements is: +</p> +<pre><code> x = l * l * l / (6 * <b>R</b> * <b>L</b>) + r = <b>L</b> * <b>R</b>/l +</code></pre> +<p> +where +</p> +<ul><li> +<strong>l</strong> is the distance along the tangent to the easement. +</li> +<li> +<strong>R</strong> is the final radius of the easement. +</li> +<li> +<strong>L</strong> is the total length of the easement along the tangent. +</li> +<li> +<strong>x</strong> is the offset from the tangent at <strong>l</strong>. +</li> +<li> +<strong>r</strong> is the radius of easement curve at <strong>l</strong>. +</li> +</ul> +<p> +The Easement Button (<img src="png.d/beasement.png">) on the Main Window (<a href="mainW.html#mainW">Section 3.1</a>) changes its label to indicate the current easement value. +</p> +<p> +The following diagrams illustrates the <strong>R</strong>, <strong>X</strong> and <strong>L</strong> values and the resulting easement curve. +</p> +<p> +<img src="png.d/easeex1.png"> +</p> +<p> +<img src="png.d/easeex2.png"> +</p> +<p> +If curves with a radius larger than <strong>R</strong> or two curves (that bend in the same direction) are being connecting then the easement curve will be shorter and the offset smaller. If the computed offset is small then no easement is generated. +</p> +<p> +A curved track that bends in one direction and then bends in the opposite direction is an <em>S-curve</em>. This will generate the worst case easement which is two easement curves placed end to end. +</p> +<p> +Refer to instruction in <a href="EasementsSectional.html#EasementsSectional">section 2.10.4.3</a> when using sectional track. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Easements and Sectional Track</title> +<link rel="previous" href="EasementsTraditional.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="fontSelW.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="EasementsSectional"></a>2.10.4.3 <a name="i0"></a>Easements and Sectional Track</h1> +<p> +Easements require the possibility of creating track with arbitrary radii. Therefore easements are not possible if sectional track is used. It is best to turn <strong>Easements</strong> off when using sectional track. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Font Selection</title> +<link rel="previous" href="EasementsSectional.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdLayout.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="fontSelW"></a>2.10.5 <a name="i0"></a>Font Selection</h1> +<p> +The font selection dialog allows selection of the font used by the text (<a href="cmdText.html#cmdText">Section 2.3.9</a>) command. This command is valid only on UNIX based systems. +</p> +<p> +<img src="png.d/fonts.png"> +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Layout Dialog</title> +<link rel="previous" href="fontSelW.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdPref.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdLayout"></a>2.10.6 <a name="i0"></a>Layout Dialog</h1> +<p> +The <strong>Layout Options</strong> dialog, displayed by the Options (<a href="optionM.html#optionM">Section 2.10</a>) or the File (<a href="fileM.html#fileM">Section 2.5</a> menu, contains items controlling the current layout. +</p> +<dl><dd> +<img src="png.d/layout.png"> +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Gauge</strong> - Drop down menu used to select track gauge. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Height</strong> - Height of layout drawing which, depending on the <strong>Unit</strong> setting (English or Metric) established in the <strong>Preferences</strong> dialog (<a href="cmdPref.html#cmdPref">Section 2.10.7</a>), is measured in inches or centimeters. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Room Width</strong> - Width of layout drawing which, depending on the <strong>Unit</strong> setting (English or Metric) established in the <strong>Preferences</strong> dialog (<a href="cmdPref.html#cmdPref">Section 2.10.7</a>), is measured in inches or centimeters. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Scale</strong> - Drop down menu used to select track scale. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Title</strong> - Two lines that can be used to enter title and subtitle descriptions for the layout. Information entered in these fields will be shown on any printout of your layout design. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Maximum Track Grade</strong> - Specifies maximum track elevation expressed as a percent (%). Tracks with a larger elevation are considered exceptional and drawn in the exception (<a href="cmdRgbcolor.html#cmdRgbcolor">Section 2.10.1</a>) color. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Minimum Track Radius</strong> - Specifies minimum track radius (in inches or centimeters). Curved tracks with a smaller radius are considered exceptional and drawn in the exception (<a href="cmdRgbcolor.html#cmdRgbcolor">Section 2.10.1</a>) color. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Background File Name</strong> - The last 40 characters of the full file pathname for the image used for a temporary background behind all the drawn objects. It is set using the <strong>Browse</strong> and reset with the <strong>Clear</strong> buttons. It is also cleared along with all the other background values after a <strong>Open</strong> or <strong>New</strong> command. The file is initally specified to be in the local file system. In order to send it along with the layout, use <strong>Save As</strong> command and specify the <a name="i1"></a>Archive Archive format (*.xtce). This will create a single zipped package file containing the layout and the image file which can be sent and will open on a different system. If this has been done, after <strong>Open</strong> of the archive, the image file path will point into the extracted archive file directory. It can be changed to a new local file and the next <strong>Save</strong> will rebuild the package using the new image file instead of the old one. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Background Pos X, Y</strong> - The offset of the bottom left corner of the background image from the origin (in inches or centimeters) after rotation. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Background Size</strong> - The model size (in inches or cm) to scale the base of the background image to (measured from bottom left to bottom right as displayed after any rotation has been applied). Note - A value of 0.0 means that no scaling is applied and the image is shown at its current size in pixels regardless of scale or zoom. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Background Screen</strong> - The amount of screening (from 0 to 100%) to apply to the background image. Screening allows objects drawn over the image to be seen more clearly. 0 means no screening, while 100% means noting will be shown. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Background Angle</strong> - The rotation angle to apply to the background image (in degrees) about its center before it is moved so that its bottom left corner is offset by the <strong>Background Pos</strong> setting. +</dd> +</dl> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Preferences Dialog</title> +<link rel="previous" href="cmdLayout.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdSticky.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdPref"></a>2.10.7 <a name="i0"></a>Preferences Dialog</h1> +<p> +This dialog controls some parameters which likely will not be changed frequently. +</p> +<dl><dd> +<img src="png.d/pref.png"> +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Angles</strong> - controls the angle system. <strong>Polar</strong>: 0° is up and angles are measured clockwise, or <strong>Cartesian</strong>: 0° is to the right and angles are measured counter-clockwise. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>AutoSave</strong> <a name="i1"></a>AutoSave - specifies the number of Check Points taken before an AutoSave. The same number of checkpoints are retained in a circular archive set in the (<a href="workDir.html#workDir">Section 1.9.3</a>) named for the layout file. Setting this value to 0 disables AutoSave. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Balloon Help</strong> - disables the display of <strong>Balloon Help</strong> (<a href="windowTerms.html#windowTerms">Section B.1</a>) which usually is shown when the cursor is placed over a control. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Show Flex-track</strong> - disables the display or <strong>Flex-track</strong> (<a href="generalTerms.html#generalTerms">Section B.2</a>) which is shown on the left of the Toolbar. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Check Point</strong> <a name="i2"></a>AutoSave - specifies the Check Point frequency; the number of modifications made to the layout since the last save. The layout is automatically saved to the Check Point file (<a href="workDir.html#workDir">Section 1.9.3</a>) when the Check Point frequency is reached. Setting this value to 0 disables use of the Checkpoint file <em>and AutoSave</em>. Upon restart, if the program was not saved normally, the user will be prompted to see if they want to resume at the last checkpoint. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Connection Angle</strong> - as below for Connection Distance for the angle between endpoints. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Connection Distance</strong> - the maximum distance between endpoints that can be connected. This affects the <strong>Join</strong> (<a href="cmdJoin.html#cmdJoin">Section 2.2.7</a>) command and auto-connection during <strong>Parallel</strong> (<a href="cmdParallel.html#cmdParallel">Section 2.1.5</a>) commands and placing <strong>Turnouts</strong> (<a href="cmdHotBar.html#cmdHotBar">Section 2.7</a>). The default value for this field is 0.100 inches or 0.254 CM. Changing this value is not recommended. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Drag Distance</strong> - controls how far you can move the cursor (in pixels) before <em>XTrackCAD</em> considers the action to be a drag instead of a click. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Drag Timeout</strong> - controls how long you can hold a mouse button down (in milliseconds) before <em>XTrackCAD</em> considers the action to be a drag instead of a click. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Length Format</strong> - controls how lengths are displayed. Combinations of feet and inches (or meters, centimeters and millimeters) with support for decimal or fractional measures. <strong>Note:</strong> lengths can be entered in any format and are converted on entry. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Max Coupling Speed</strong> - trains (<a href="cmdTrain.html#cmdTrain">Section 2.9.8</a>) moving faster than this speed will crash when running into other trains or hitting the end of a track or an open turnout. Crashed trains must be manually moved back onto the track. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Min Grid Spacing</strong> - minimum distance between <strong>Grid</strong> (<a href="cmdGrid.html#cmdGrid">Section 2.12.2</a>) lines (in pixels). If the grid lines are closer then drawing them is suppressed. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Min Track Length</strong> - specifies the minimum length of a track. Shorter tracks will not be created. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>On Program Startup</strong> - if set to ‘Load Last Layout’, <em>XTrackCAD</em> will automatically re-open the layout file that was open when <em>XTrackCAD</em> last closed. Selecting ‘Start New Layout’ opens a blank layout canvas. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Turntable Angle</strong> - minimum angle between adjacent tracks connected to a <strong>Turntable</strong> (<a href="cmdTurntable.html#cmdTurntable">Section 2.1.9</a>). +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Units</strong> - choose between English (inches) or Metric (centimeters) measurements. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Write Settings</strong> - Save the current settings to a named settings file +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Read Settings</strong> - Load settings from a named settings file +</dd> +</dl> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Sticky Dialog</title> +<link rel="previous" href="cmdPref.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdStatusbar.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdSticky"></a>2.10.8 <a name="i0"></a>Sticky Dialog</h1> +<p> +By default, when commands complete, the defined <strong>Default Command</strong> (<a href="cmdCmdopt.html#cmdCmdopt">Section 2.10.2</a>) becomes active. If a command is <strong>sticky</strong>, the defined <strong>Default Command</strong> is ignored and the current command remains active after completion. +</p> +<p> +The <strong>Sticky</strong> dialog controls which commands remain active after completion. +</p> +<p> +<img src="png.d/sticky.png"> +</p> +<p> +Selecting a command makes it <strong>sticky</strong>. Un-selecting a command causes the defined <strong>Default Command</strong> to become active after command completion. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Status Bar</title> +<link rel="previous" href="cmdSticky.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="viewM.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdStatusbar"></a>2.11 Status Bar</h1> +<p> +The <em>Status Bar</em> contains fields that can be modified depending on command: +</p> +<dl><dd> +The Line Width and Color for <em>Straight Line</em>, <em>Curved Line</em>, <em>Circle</em>, <em>Polygon</em>, <em>Box</em> or <em>PolyLine</em> objects. The Line Width is specified in pixels for the current Drawing Scale. Zooming (<a href="viewM.html#viewM">Section 2.12</a>) in or out causes the lines to be drawn wider or narrower. +</dd> +</dl> +<p> + +</p> +<dl><dd> +The Color for <em>Filled Circles</em> or <em>Polygons</em>. +</dd> +</dl> +<p> + +</p> +<dl><dd> +The size of a <em>Dimension Line</em> (<em>Tiny</em>, <em>Small</em>, <em>Medium</em> or <em>Large</em>) +</dd> +</dl> +<p> + +</p> +<dl><dd> +The type, size and orientation of lumber used for <em>Bench-work</em> (regular rectangular, L-Girder or T-Girder). +</dd> +</dl> +<p> + +</p> +<dl><dd> +The seperation and radius factor for Parallel commands +</dd> +</dl> +<p> + +</p> +<dl><dd> +The diameter of a Turntable +</dd> +</dl> +<p> + +</p> +<dl><dd> +After and add or during a Modify of a Draw object or segment, length, radius and/or relative angles are shown in modifiable fields. These will change the dimensions of the last object when <strong>Enter</strong> or <strong>Tab</strong> is pressed or the cursor leaves the entry field. +</dd> +</dl> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>View Menu</title> +<link rel="previous" href="cmdStatusbar.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdMagneticSnap.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="viewM"></a>2.12 <a name="i0"></a>View Menu</h1> +<p> +<img src="png.d/mview.png"> +</p> +<p> +The <strong>View Menu</strong> shows commands affecting the display of the <strong>Main Canvas</strong> (<a href="mainW.html#mainW">Section 3.1</a>). +</p> +<dl><dd> +<strong>Change Grid</strong> - Displays the <strong>Snap Grid</strong> dialog. The <strong>Snap Grid</strong> forces the cursor (for some commands) to be on a grid to control track placement. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Enable SnapGrid</strong> - Enables (or disables) the <strong>Snap Grid</strong> (<a href="cmdGrid.html#cmdGrid">Section 2.12.2</a>). +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Redraw</strong> - Redraws the <strong>Main Canvas</strong>. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Redraw All</strong> - Redraws the <strong>Main Canvas</strong> and the <strong>Map Window</strong> (<a href="cmdMap.html#cmdMap">Section 3.2.2</a>). +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Show Snap-Grid</strong> - <a name="i1"></a> Toggles display of the <strong>Snap Grid</strong> on and off. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Magnetic Snap On/Off</strong> - Toggles <a name="i2"></a>Magnetic Snap (<a href="cmdMagneticSnap.html#cmdMagneticSnap">Section 2.12.1</a>) for Add Operations on and off. The magnets make tracks auto-align and shapes touch when the cursor or object is close. They can be defeated on each operation by holding down <em>Alt</em>. If the Magnets are off, holding down <em>Alt</em> will enable them. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<img src="png.d/bmap.png"> <strong> Show/Hide Map</strong> - Toggles display of the <strong>Map Window</strong> <a name="i3"></a> on and off. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Tool-bar</strong> - Command button groups displayed on the <strong>Tool-bar</strong> are selected using the Tool-bar Configuration Menu (<a href="toolbarM.html#toolbarM">Section 2.12.3</a>). +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Pan/Zoom</strong> - move or resize the viewport using the mouse (<a href="cmdPan.html#cmdPan">Section 2.2.11</a>). +</dd> +</dl> +<p> + +</p> +<dl><dd> +<img src="png.d/mzoomscale.png"> +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Zoom</strong> - This sub-menu is used to select a specific drawing scale ratio for the <strong>Main Canvas</strong>. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Zoom In</strong> - Increases magnification of the <strong>Main Canvas</strong>. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Zoom Out</strong> - Decreases magnification of the <strong>Main Canvas</strong>. +</dd> +</dl> +<p> + +</p> +<p> +When zooming in or out, the corresponding highlighted area of the <strong>Map Window</strong> (<a href="cmdMap.html#cmdMap">Section 3.2.2</a>) changes size to match that which appears on the <strong>Main Canvas</strong> (<a href="mainW.html#mainW">Section 3.1</a>). +</p> +<hr> +<ul> +<li><a href="cmdMagneticSnap.html#cmdMagneticSnap">2.12.1 Magnetic Snap</a></li> +<li><a href="cmdGrid.html#cmdGrid">2.12.2 Grid Dialog</a></li> +<li><a href="toolbarM.html#toolbarM">2.12.3 </a></li> +<li><a href="cmdZoom.html#cmdZoom">2.12.4 Zoom</a></li> +</ul> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Magnetic Snap</title> +<link rel="previous" href="viewM.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdGrid.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdMagneticSnap"></a>2.12.1 Magnetic Snap</h1> +<p> +The <strong>MagneticSnap</strong> feature eases constructing and assembling Tracks and Draw objects by "snapping" the end of new objects to existing objects. For existing track objects the point snapped to is always an open end point. The snap operates when "close" to the object (a few pixels distant) and an anchor point (a blue circle) is displayed when this will occur if the mouse is clicked. +</p> +<p> + When Adding Draw line objects, the snap point is the nearest point on the existing object. A snap to the end of a line object can be selected by positioning the cursor close to the end of the line but off it, in the direction of the line. This will ensure the closest point is the end. +</p> +<p> + The <strong>MagneticSnap</strong> feature is enabled and disabled using either the magnet icon which is part of the <strong>SnapGrid</strong> Toolbar button set, or using the View (<a href="viewM.html#viewM">Section 2.12</a>) menu. +</p> +<p> +For each part of an Add or Move or Rotate operation, the current state of <strong>MagneticSnap</strong> can be temporarily inverted using the <strong>Alt</strong> key. This enables snapping to be inhibited for a single part of an operation (or conversely enabled for just one part). +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Grid Dialog</title> +<link rel="previous" href="cmdMagneticSnap.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="toolbarM.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdGrid"></a>2.12.2 <a name="i0"></a>Grid Dialog</h1> +<p> +The <strong>Grid</strong> dialog, displayed by <strong>Change Grid</strong> on the View (<a href="viewM.html#viewM">Section 2.12</a>) menu, specifies the origin, angle and other parameters of the Snap Grid. The Snap Grid can sbe used to snap the position of the cursor during the <strong>Curve</strong> (<a href="cmdCurve.html#cmdCurve">Section 2.1.2</a>), <strong>Circle</strong> (<a href="cmdCircle.html#cmdCircle">Section 2.1.1</a>), <strong>Cornu</strong> (<a href="cmdCornu.html#cmdCornu">Section 2.1.2.6</a>), <strong>Modify</strong> (<a href="cmdModify.html#cmdModify">Section 2.2.8</a>), <strong>Straight</strong> (<a href="cmdStraight.html#cmdStraight">Section 2.1.6</a>), <strong>Draw</strong> (<a href="cmdDraw.html#cmdDraw">Section 2.3</a>) and <strong>Turntable</strong> (<a href="cmdTurntable.html#cmdTurntable">Section 2.1.9</a>) commands. +</p> +<p> +<img src="png.d/grid.png"> +</p> +<p> +The <strong>Grid</strong> dialog contains controls affecting the horizontal and vertical snap grid lines. Each dimension can be independently controlled. +</p> +<dl><dd> +The <strong>Spacing</strong> value specifies the distance between major grid lines, which are drawn as solid lines on the layout. The value of the distance is entered in either inches or centimeters depending on the value of the <strong>Units</strong> setting in Options->Preferencecs (<a href="cmdPref.html#cmdPref">Section 2.10.7</a>) menu. +</dd> +</dl> +<p> + +</p> +<dl><dd> +The <strong>Divisions</strong> value adds the minor Grid lines between the major Grid lines, which are drawn as a series of dots on the layout. Specifying a value of 0 or 1 as the division value removes the minor grid lines. +</dd> +</dl> +<p> + +</p> +<dl><dd> +The Grid can be enabled or disabled in each dimension via the <strong>Enable</strong> check box. The action of snapping is secondary to <strong>Magnetic Snap</strong> if enabled, and is suppressed if <strong>Alt</strong> is held. +</dd> +</dl> +<p> + +</p> +<dl><dd> +The <strong>X</strong> and <strong>Y</strong> coordinates relate to the anchor point of the X and Y Axis. Default values for <strong>X</strong> and <strong>Y</strong> are zero (0). Entering a value of one for <strong>X</strong> causes the Main grid line on the Drawing Canvas to shift left one unit. Entering a value of two causes the Main grid line to shift by two units and so on. The <strong>Y</strong> axis is affected in the similar manner except the grid moves down rather than left. +</dd> +</dl> +<p> + +</p> +<dl><dd> +Negative values can be used for X and Y values. Using such cause the Main Grid to shift right for the X Axis and up for the Y Axis. +</dd> +</dl> +<p> + +</p> +<dl><dd> +The A coordinate relates to the Angle of grid rotation. The default value for this coordinate is zero. Entering a value greater than 0 and less than 90 will cause the Main Grid to rotate clockwise by the number of degrees entered. Entering a negative value causes the grid to rotate counter-clockwise. +</dd> +</dl> +<p> +The origin and angle of the Grid can be adjusted directly or by dragging on the layout. <em>Left+Drag</em> moves the origin of the Grid, and <em>Right+Drag</em> rotates the grid. <em>Shift+Right-Click</em> (<a href="cmdAcclKeys.html#cmdAcclKeys">Section 3.4</a>) displays a pop-up menu allowing rotation of the grid by various predefined angles. +</p> +<p> +Whether the Snap Grid is drawn is controlled by the <strong>Show</strong> check-box. Also, if the layout is Zoomed Out (<a href="cmdZoom.html#cmdZoom">Section 2.12.4</a>) the minor and major grid lines may be too close together to be drawn. The minimum pixel distance between grid lines is controlled by the <strong>Min Grid Spacing</strong> value on the <strong>Preferences</strong> (<a href="cmdPref.html#cmdPref">Section 2.10.7</a>) dialog. +</p> +<p> +<strong>Note:</strong> on slow machines drawing the Grid can take noticeable time. Performance can be improved by selecting a larger value for <strong>Min Grid Spacing</strong>. +</p> +<p> +<img src="png.d/bgsnap.png"> <strong>Grid Buttons</strong> on the Tool-bar (<a href="mainW.html#mainW">Section 3.1</a>) can be used to Enable/Disable and to Show/Hide the Snap Grid. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title></title> +<link rel="previous" href="cmdGrid.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdZoom.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="toolbarM"></a>2.12.3 <a name="i0"></a></h1> +<p> +<img src="png.d/mtoolbar.png"> +</p> +<p> +Command button groups displayed on the <strong>Tool-bar</strong> are selected using the Tool-bar Configuration Menu (<a href="#toolbarM">Section 2.12.3</a>). If none of the command button groups are selected, the <strong>Tool-bar</strong> is not shown. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Zoom</title> +<link rel="previous" href="toolbarM.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="windowM.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdZoom"></a>2.12.4 <a name="i0"></a>Zoom</h1> +<p> +<img src="png.d/bgzoom.png"> +</p> +<p> +The <strong>Zoom In</strong> and <strong>Zoom Out</strong> actions can also be accessed using buttons on the Tool Bar or usig the <strong>Pan/Zoom</strong> Mode button. The Mouse Wheel, PAGE DOWN and PAGE UP keys can also be used to zoom in and out. +</p> +<p> +Holding down the Shift key while clicking the <strong>Zoom In</strong> or <strong>Zoom Out</strong> buttons sets the Drawing Scale to a <em>Programmed Zoom</em> value. +</p> +<dl><dd> +<a name="i1"></a><em>Zoom/Pan Shortcut Keys</em> +<p> + +</p> +<ul><li> +Keys '1'-'9' set the zoom to between 1::1 and 1::9. +</li> +</ul> +<p> + +</p> +<ul><li> +Key 'e' sets the zoom to a value that allows all the room to be shown and moves the origin of bottom left of the window to be 0,0 +</li> +</ul> +<p> + +</p> +<ul><li> +Key 's' sets the zoom to show the selected set of objects and pans the window to center the highlit area. +</li> +</ul> +<p> + +</p> +<ul><li> +Key '0' or 'o' keeps the zoom as is, but moves the origin of the bottom left of the window to 0,0 +</li> +</ul> +<p> + +</p> +<ul><li> +Key 'c' moves the center of the window to the cursor position +</li> +</ul> + +</dd> +</dl> +<p> +Normally a zoom in more of more than 1:1 is not possible, however if the Ctrl key is held down while the <strong>Zoom In</strong> button is pressed a zoom less that 1:1 can be achieved. This function is useful when working on detail. +</p> +<p> +Pressing the middle Zoom button on the Tool Bar pop-ups a list of Zoom factors that can be select from. +</p> +<p> + +</p> +<p> +<em>Note</em> - The value of Zoom 1:1 will be set using 96 dpi as a default, it can be overriden using a Configuration Value in the Preferences section of ScreenDPI. +</p> +<p> + +</p> +<dl><dd> +See <strong>Main Window Overview</strong> (<a href="mainW.html#mainW">Section 3.1</a>) for details on how to <strong>Pan</strong> the <strong>Main Canvas</strong>. +</dd> +</dl> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Window Menu</title> +<link rel="previous" href="cmdZoom.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="navigation.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="windowM"></a>2.13 Window Menu</h1> +<p> +<img src="png.d/mwindow.png"> +</p> +<p> +The <strong>Window Menu</strong> typically contains selections for bringing any open window into view. It's used as follows; +</p> +<dl><dd> +<em>XTrackCAD</em> permits multiple dialog windows to be open at any one time. When a large number of windows are open it can become difficult to locate and bring a specific window into focus. Use the <strong>Window Menu</strong> function to select and bring the desired window to the top of the screen. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<img src="png.d/openwindows.png"> +</dd> +</dl> +<p> + +</p> +<dl><dd> +Apart from bringing the <strong>Map Window</strong> (<a href="cmdMap.html#cmdMap">Section 3.2.2</a>) to the foreground, the <strong>Map</strong> menu item can also be used to re-opened a closed <strong>Map Window</strong>. +</dd> +</dl> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Navigation</title> +<link rel="previous" href="windowM.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="mainW.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="navigation"></a>Chapter 3: Navigation</h1> +<p> +The Main Window includes a title bar along the top that describes the contents of the window, followed by a tool bar that contains user interface buttons. Most of the window's remaining area is used to display the layout. A footer border contains information including system messages. +</p> +<p> +Most windows can be opened, closed, resized, minimized, and moved around the screen. The close, minimize, and zoom buttons are located on the right side of the title bar. Minimizing a window will close the contents of the window, but store a reference to it in the Task bar. Closing a window will make it disappear completely (so you may be asked to save your changes first). To move a window, click on the title bar and drag the window where you want it. +</p> +<ul> +<li><a href="mainW.html#mainW">3.1 Main Window Overview</a></li> +<li><a href="generaloperation.html#generaloperation">3.2 General Operation </a></li> +<ul> +<li><a href="enterValue.html#enterValue">3.2.1 Entering Values</a></li> +<li><a href="cmdMap.html#cmdMap">3.2.2 Map Window</a></li> +</ul> +<li><a href="kbshortcuts.html#kbshortcuts">3.3 Keyboard Shortcuts </a></li> +<ul> +<li><a href="cmdAdd.html#cmdAdd">3.3.1 Add Commands</a></li> +<li><a href="cmdChange.html#cmdChange">3.3.2 Change Commands</a></li> +<li><a href="kbshortcutdraw.html#kbshortcutdraw">3.3.3 Draw Commands</a></li> +<li><a href="cmdEdit.html#cmdEdit">3.3.4 Edit Commands</a></li> +<li><a href="cmdFile.html#cmdFile">3.3.5 File Commands</a></li> +<li><a href="kbshortcutHotBar.html#kbshortcutHotBar">3.3.6 Hot Bar</a></li> +<li><a href="cmdMacro.html#cmdMacro">3.3.7 Macro Commands</a></li> +<li><a href="kbshortcutMainCanvas.html#kbshortcutMainCanvas">3.3.8 Main Drawing Canvas</a></li> +<li><a href="cmdManage.html#cmdManage">3.3.9 Manage Commands</a></li> +<li><a href="cmdOption.html#cmdOption">3.3.10 Option Commands</a></li> +<li><a href="cmdView.html#cmdView">3.3.11 View Commands</a></li> +</ul> +<li><a href="cmdAcclKeys.html#cmdAcclKeys">3.4 Mouse Actions</a></li> +<ul> +<li><a href="mouseBcmd.html#mouseBcmd">3.4.1 Context Sensitive Menus</a></li> +</ul> +</ul> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Main Window Overview</title> +<link rel="previous" href="navigation.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="generaloperation.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="mainW"></a>3.1 <a name="i0"></a>Main Window Overview</h1> +<dl><dt> +Main Window Overview +</dt> +</dl> +<p> + +</p> +<dl><dd> +<img src="png.d/maintagged.png"> +</dd> +</dl> +<p> + +</p> +<dl><dd> +The size of the main window can be changed by dragging on the resizing borders. +</dd> +</dl> +<p> + +</p> +<dl><dd> +Minimizing the <em>Main Window</em> will minimize all <em>XTrackCAD</em> windows. +</dd> +</dl> +<p> + +</p> +<dl><dt> +The <strong>Main Window</strong> contains (from the top down): +</dt> +</dl> +<p> + +</p> +<dl><dt> +<em>Title bar</em> +</dt> +<dd> +<img src="png.d/title.png"> +</dd> +</dl> +<p> + +</p> +<dl><dd> +Current filename, <em>XTrackCAD</em> version number, and window manager buttons. An asterisk (*) after the filename indicates that there are unsaved changes. +</dd> +</dl> +<p> + +</p> +<dl><dt> +<em>Menu Bar</em> +</dt> +<dd> +<img src="png.d/menu.png"> +</dd> +</dl> +<p> + +</p> +<dl><dd> +Contains from left to right; +<ul><li> +File (<a href="fileM.html#fileM">Section 2.5</a>) +</li> +<li> +Edit (<a href="editM.html#editM">Section 2.4</a>) +</li> +<li> +View (<a href="viewM.html#viewM">Section 2.12</a>) +</li> +<li> +Add (<a href="addM.html#addM">Section 2.1</a>) +</li> +<li> +Change (<a href="changeM.html#changeM">Section 2.2</a>) +</li> +<li> +Draw (<a href="cmdDraw.html#cmdDraw">Section 2.3</a>) +</li> +<li> +Manage (<a href="manageM.html#manageM">Section 2.9</a>) +</li> +<li> +Options (<a href="optionM.html#optionM">Section 2.10</a>) +</li> +<li> +Macro (<a href="macroM.html#macroM">Section 2.8</a>) +</li> +<li> +Window (<a href="windowM.html#windowM">Section 2.13</a>) and; +</li> +<li> +Help (<a href="helpM.html#helpM">Section 2.6</a>) menu buttons. +</li> +</ul> + +</dd> +</dl> +<p> + +</p> +<dl><dt> +<em>Tool Bar</em> +</dt> +<dd> +<img src="png.d/toolbar.png"> +</dd> +</dl> +<p> + +</p> +<dl><dd> +Manipulate track and other objects The toolbar buttons size can be adjusted using a User Preference in the .ini or .rc file (on Windows or Mac/Linux) in the xtrkcad directory. If running Linux or Mac a line <code>"Preference.LargeIcons: 1.5"</code> can be added. The scale value can be from 1.0 to 2.0 only. The corresponding configuration Windows would be +</dd> +</dl> +<pre><code> [Preference] + LargeIcons=1.5 +</code></pre> +<p> +<em>Note</em> The configuration file uses the language specific definitions for the decimal separator. Eg. in Germany, where the comma is used, the correct value would be<code>LargeIcons=1,5</code>. +</p> +<p> + +</p> +<dl><dt> +<em>Hot Bar</em> (<a href="cmdHotBar.html#cmdHotBar">Section 2.7</a>) +</dt> +<dd> +<img src="png.d/hotbar.png"> +</dd> +</dl> +<p> + +</p> +<dl><dd> +Scrolling list of Turnouts and Structures +</dd> +</dl> +<p> + +</p> +<dl><dt> +<em>Main Canvas</em> +</dt> +<dd> +<img src="png.d/maincanvas.png"> +</dd> +</dl> +<p> + +</p> +<dl><dd> +Main drawing area with rulers along each side. +</dd> +</dl> +<p> + +</p> +<dl><dd> +The <strong>Main Canvas</strong> is where all tracks and objects (and optional background image) are drawn. +</dd> +</dl> +<p> + +</p> +<dl><dd> +The <strong>Background Image</strong> is drawn on the main canvas if specified in the <a href="cmdLayout.html#cmdLayout">Section 2.10.6</a> menu. +</dd> +</dl> +<p> + +</p> +<dl><dd> +The center of the <strong>Main Canvas</strong> can be moved (Panned) using the; +<ul><li> +ARROW Keys +</li> +<li> +Left-Click and drag in <a href="cmdZoom.html#cmdZoom">Section 2.12.4</a> +</li> +<li> +"@" key in <strong>Select</strong>, <strong>Modify</strong> and <strong>Pan/Zoom</strong>. +</li> +<li> +Mouse Wheel - adding <em>Shift</em> key will Pan the screen up and down. Adding <em>Ctrl</em> as well Pans left and right. +</li> +<li> +Horizontal Mouse Wheel - adding <em>Shift</em> key will Pan the screen left and Right (if available) +</li> +<li> +Scroll Left and Right - if the scroll left and right guestures are mapped to the trackpad by the operating system, with <em>Shift</em> depressed the screen will Pan. +</li> +<li> +On mice and systems that support Three Button Mice, holding the <em>Middle Mouse Button</em> while dragging, will Pan the canvas. +</li> +</ul> + +</dd> +<dd> +The <strong>Main Canvas</strong> can be panned so that the area beyond the room boundaries is shown (the <strong>grey</strong> area). The <strong>Constrain Drawing Area to Room Boundaries</strong> option on the <strong>Display</strong> (<a href="cmdDisplay.html#cmdDisplay">Section 2.10.3</a>) dialog under the <strong>Options</strong> (<a href="optionM.html#optionM">Section 2.10</a>) menu forces the <strong>Main Canvas</strong> stop panning once the room boundary is reached. Holding the <em>Control</em> key while panning will invert the value of this setting. +</dd> +</dl> +<p> + +</p> +<dl><dd> +The scale of the <strong>Main Canvas</strong> can be changed using the; +<ul><li> +<strong>Zoom</strong> selections (<a href="cmdZoom.html#cmdZoom">Section 2.12.4</a>) under the <strong>View</strong> (<a href="viewM.html#viewM">Section 2.12</a>) menu +</li> +<li> +<strong>Zoom</strong> buttons on the <strong>Tool-bar</strong> +</li> +<li> +Mouse Wheel +</li> +<li> +PAGE UP and PAGE DOWN keys +</li> +<li> +<strong>Pan/Zoom</strong> <a href="cmdPan.html#cmdPan">Section 2.2.11</a> button on the <strong>Tool-bar</strong> +</li> +</ul> +<p> +<strong>Note:</strong> If The scale 1:1 is reached, "Macro Zoom" mode can be entered using CTRL+PageDown - with repeated presses a scale of 10::1 is possible. +</p> + +</dd> +<dd> +When <strong>Zooming</strong>, the Main Canvas will retain the center of the display if <strong>Constrain Drawing Area to Room Boundaries</strong> is not set. Otherwise, as much of the room as possible is displayed, and any <strong>grey</strong> area will be to the right and above the room. +</dd> +</dl> +<p> + +</p> +<dl><dd> +Tracks will be drawn with two lines and ties if you zoom in. When the drawing scale is 1:1 a dashed centerline is also drawn for each track. +</dd> +</dl> +<p> + +</p> +<dl><dd> +The ARROW keys move the <strong>Canvas</strong> left, right, up or down by half a screen. If Shift is used together with the arrow keys, the movement will be 1/20th of screen in the selected direction. +</dd> +</dl> +<p> + +</p> +<dl><dd> +In many commands, the result that will result from clicking the mouse is shown by <em>anchors</em> which highlight the track object or feature in blue that will be affected as the mouse is dragged over the canvas and becomes close enough to select it. +</dd> +</dl> +<p> + +</p> +<dl><dt> +<em>Map Window</em> +</dt> +<dd> +<img src="png.d/map.png"> +</dd> +</dl> +<p> + +</p> +<dl><dd> +You can change which portion of the layout is displayed by using the <strong>Map Window</strong> (<a href="cmdMap.html#cmdMap">Section 3.2.2</a>). +</dd> +</dl> +<p> + +</p> +<dl><dt> +<em>Status Bar</em> +</dt> +<dd> +<img src="png.d/statusbar.png"> +</dd> +</dl> +<p> + +</p> +<dl><dd> +Contains from left to right; +<ul><li> +Drawing scale of the Main Canvas, +</li> +<li> +X position of the cursor, +</li> +<li> +Y position of the cursor, +</li> +<li> +Status and informational messages +</li> +</ul> + +</dd> +</dl> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>General Operation </title> +<link rel="previous" href="mainW.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="enterValue.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="generaloperation"></a>3.2 General Operation <a name="i0"></a></h1> +<p> +Most Windows open with three standard dialog buttons: +</p> +<dl><dd> +<strong>Cancel</strong> - Cancels dialog. Layout reverts back to its previous state. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>Help</strong> - Invokes on-line help for current command or dialog. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<strong>OK</strong> - Completes the dialog action. Layout is updated with current changes. +</dd> +</dl> +<hr> +<ul> +<li><a href="enterValue.html#enterValue">3.2.1 Entering Values</a></li> +<li><a href="cmdMap.html#cmdMap">3.2.2 Map Window</a></li> +</ul> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Entering Values</title> +<link rel="previous" href="generaloperation.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdMap.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="enterValue"></a>3.2.1 <a name="i0"></a>Entering Values</h1> +<p> +Lengths and Distances can be entered in a variety of formats; +</p> +<dl><dd> +<em>12ft 4 1/2in, 12' 4.5", 148.500, 1.234m, 123.4cm or 1234mm</em> are all valid values. +</dd> +</dl> +<p> + +</p> +<dl><dd> +Adding the Equal Sign (<code>=</code>) key after an entry will reformat the value entered to your preferred length format (<a href="cmdPref.html#cmdPref">Section 2.10.7</a>). +</dd> +</dl> +<p> + +</p> +<dl><dd> +Adding the "<code>p</code>" key after an entry will convert a prototype measurement to a scale measurement by dividing the value entered by the ratio for the current scale. +</dd> +</dl> +<p> + +</p> +<dl><dd> +Adding the "<code>s</code>" key after an entry will convert a scale measurement to a prototype measurement. +</dd> +</dl> +<p> +The conversion will happen when the <em>Tab</em> key is used, or the cursor is moved to a different entry box. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Map Window</title> +<link rel="previous" href="enterValue.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="kbshortcuts.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdMap"></a>3.2.2 <a name="i0"></a>Map Window</h1> +<p> +<img src="png.d/map.png"> +</p> +<p> +The <em>Map Window</em> area shows the complete layout at a reduced scale. A highlighted (reverse video) area shows what portion is visible in the Main Window (<a href="mainW.html#mainW">Section 3.1</a>). The highlighted area can be Left+Dragged (<a href="windowTerms.html#windowTerms">Section B.1</a>) around the layout to change the origin of the Main Canvas. The highlighted area changes size as Zoom In (<a href="viewM.html#viewM">Section 2.12</a>) and Zoom Out (<a href="viewM.html#viewM">Section 2.12</a>) are selected. +</p> +<p> +You can also Right+Drag (<a href="windowTerms.html#windowTerms">Section B.1</a>) on the Map window to set the origin and scale of the Main Canvas. +</p> +<p> +The size of the <em>Map Window</em> changes when you change the Room Size (see <a href="cmdLayout.html#cmdLayout">Section 2.10.6</a>). You can also change the Map Scale (<a href="cmdDisplay.html#cmdDisplay">Section 2.10.3</a>) on the Display (<a href="cmdDisplay.html#cmdDisplay">Section 2.10.3</a>) dialog to change the size of the <em>Map Window</em>. +</p> +<p> +If you close the <em>Map Window</em>, you can reopen it by the <em>Window</em> menu. +</p> +<p> +Visibility of the <em>Map Window</em> can be toggled by pressing <em>Ctrl+Space</em> +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Keyboard Shortcuts </title> +<link rel="previous" href="cmdMap.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdAdd.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="kbshortcuts"></a>3.3 <a name="i0"></a>Keyboard Shortcuts <a name="i1"></a></h1> +<p> +The term Shortcut key refers to specific key combinations which are used to accomplish an action which otherwise would be accomplished by moving a MOUSE and /or selecting from a Menu. Shortcut keys are often key combinations consisting of the letter key pressed along with the Alt or Ctrl key. +</p> +<p> +Instead of using the menus or the buttons on the <strong>Tool-bar</strong> (<a href="mainW.html#mainW">Section 3.1</a>), most <em>XTrackCAD</em> commands may be invoked through use of Shortcut keys. +</p> +<dl><dd> +The <code>RETURN</code> key has the same effect as pressing the <strong>OK</strong> button on the current dialog. +</dd> +</dl> +<p> + +</p> +<dl><dd> +The <code>ESCAPE</code> key cancels the current command. All selected tracks are unselected. The <strong>Properties</strong> (<a href="cmdDescribe.html#cmdDescribe">Section 2.2.13</a>) or <strong>Select</strong> (<a href="cmdSelect.html#cmdSelect">Section 2.2.16</a>) command becomes the current command. +</dd> +</dl> +<p> + +</p> +<dl><dd> +The <code>F1</code> key opens the Help page for the currently selected command. <code>Shift+F1</code> opens the Contents Help Page. +</dd> +</dl> +<p> + +</p> +<dl><dd> +The <code>PAGE UP</code> and <code>PAGE DOWN</code> keys will zoom out or zoom in. +</dd> +</dl> +<p> + +</p> +<dl><dd> +The <code>ARROWS</code> key will pan the canvas right, left, up and down. +</dd> +</dl> +<p> + +</p> +<dl><dd> +The <code>DELETE</code> or the <code>BackSpace</code> key invokes the <strong>Delete</strong> (<a href="cmdDelete.html#cmdDelete">Section 2.4.4</a>) command. +</dd> +</dl> +<p> +Several Shortcut key commands are used in conjunction with the mouse. These commands are listed in <a href="cmdAcclKeys.html#cmdAcclKeys">Section 3.4</a>. +</p> +<hr> +<ul> +<li><a href="cmdAdd.html#cmdAdd">3.3.1 Add Commands</a></li> +<li><a href="cmdChange.html#cmdChange">3.3.2 Change Commands</a></li> +<li><a href="kbshortcutdraw.html#kbshortcutdraw">3.3.3 Draw Commands</a></li> +<ul> +<li><a href="addText.html#addText">3.3.3.1 Add Text</a></li> +<li><a href="cmdDrawCircle.html#cmdDrawCircle">3.3.3.2 Draw Circles</a></li> +<li><a href="cmdDrawCurve.html#cmdDrawCurve">3.3.3.3 Draw Curved Lines</a></li> +<li><a href="cmdDrawShape.html#cmdDrawShape">3.3.3.4 Draw Shapes</a></li> +<li><a href="cmdDrawStraight.html#cmdDrawStraight">3.3.3.5 Draw Straight Objects</a></li> +<li><a href="NoteDialog.html#NoteDialog">3.3.3.6 Note Dialog</a></li> +</ul> +<li><a href="cmdEdit.html#cmdEdit">3.3.4 Edit Commands</a></li> +<li><a href="cmdFile.html#cmdFile">3.3.5 File Commands</a></li> +<li><a href="kbshortcutHotBar.html#kbshortcutHotBar">3.3.6 Hot Bar</a></li> +<li><a href="cmdMacro.html#cmdMacro">3.3.7 Macro Commands</a></li> +<li><a href="kbshortcutMainCanvas.html#kbshortcutMainCanvas">3.3.8 Main Drawing Canvas</a></li> +<li><a href="cmdManage.html#cmdManage">3.3.9 Manage Commands</a></li> +<li><a href="cmdOption.html#cmdOption">3.3.10 Option Commands</a></li> +<li><a href="cmdView.html#cmdView">3.3.11 View Commands</a></li> +</ul> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Add Commands</title> +<link rel="previous" href="kbshortcuts.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdChange.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdAdd"></a>3.3.1 Add Commands</h1> +<dl><dt> +Add Commands +</dt> +</dl> +<p> + +</p> +<dl><dd> +Create +<ul><li> +Circle track from +<ul><li> +center - <em>Ctrl+0</em> +</li> +<li> +fixed radius circle - <em>Ctrl+8</em> +</li> +<li> +tangent - <em>Ctrl+9</em> +</li> +</ul> + +</li> +<li> +Curve track from +<ul><li> +center - <em>Ctrl+6</em> +</li> +<li> +chord - <em>Ctrl+7</em> +</li> +<li> +endpoint - <em>Ctrl+4</em> +</li> +<li> +tangent - <em>Ctrl+5</em> +</li> +</ul> + +</li> +<li> +Hand laid turnout - <em>Ctrl+Shift+I</em> +</li> +<li> +Straight track - <em>Ctrl+G</em> +</li> +<li> +Turntable - <em>Ctrl+Shift+N</em> +</li> +</ul> + +</dd> +</dl> +<p> + +</p> +<dl><dd> +Helix dialog and construction tool - <em>Ctrl+Shift+H</em> +</dd> +</dl> +<p> + +</p> +<dl><dd> +Structure dialog - <em>Ctrl+Shift+C</em> +</dd> +</dl> +<p> + +</p> +<dl><dd> +Turnout dialog - <em>Ctrl+T</em> +</dd> +</dl> +<p> + +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Change Commands</title> +<link rel="previous" href="cmdAdd.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="kbshortcutdraw.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdChange"></a>3.3.2 Change Commands</h1> +<dl><dt> +Change Commands +</dt> +</dl> +<p> + +</p> +<dl><dd> +Connect two sectional tracks - <em>Ctrl+Shift+J</em> +</dd> +</dl> +<p> + +</p> +<dl><dd> +Elevation dialog - <em>Ctrl+Shift+E</em> +</dd> +</dl> +<p> + +</p> +<dl><dd> +Join two tracks - <em>Ctrl+J</em> +</dd> +</dl> +<p> + +</p> +<dl><dd> +Properties dialog - <em>Ctrl+?</em> +</dd> +</dl> +<p> + +</p> +<dl><dd> +Modify or extend track - <em>Ctrl+M</em> +</dd> +</dl> +<p> + +</p> +<dl><dd> +Move +<ul><li> +description - <em>Ctrl+Shift+Z</em> +</li> +<li> +selected object - <em>Ctrl+Shift+M</em> +</li> +</ul> +<p> + +</p> + +</dd> +<dd> +Profile dialog - <em>Ctrl+Shift+F</em> +</dd> +</dl> +<p> + +</p> +<dl><dd> +Rotate selected object - <em>Ctrl+Shift+R</em> +</dd> +</dl> +<p> + +</p> +<dl><dd> +Select tool - <em>Ctrl+E</em> +</dd> +</dl> +<p> + +</p> +<dl><dd> +Split flex-track - <em>Ctrl+Shift+S</em> +</dd> +</dl> +<p> + +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Draw Commands</title> +<link rel="previous" href="cmdChange.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="addText.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="kbshortcutdraw"></a>3.3.3 Draw Commands</h1> +<ul> +<li><a href="addText.html#addText">3.3.3.1 Add Text</a></li> +<li><a href="cmdDrawCircle.html#cmdDrawCircle">3.3.3.2 Draw Circles</a></li> +<li><a href="cmdDrawCurve.html#cmdDrawCurve">3.3.3.3 Draw Curved Lines</a></li> +<li><a href="cmdDrawShape.html#cmdDrawShape">3.3.3.4 Draw Shapes</a></li> +<li><a href="cmdDrawStraight.html#cmdDrawStraight">3.3.3.5 Draw Straight Objects</a></li> +<li><a href="NoteDialog.html#NoteDialog">3.3.3.6 Note Dialog</a></li> +</ul> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Add Text</title> +<link rel="previous" href="kbshortcutdraw.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdDrawCircle.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="addText"></a>3.3.3.1 Add Text</h1> +<p> +Add Text +</p> +<dl><dd> +Add Text to drawing area - <em>Ctrl+Shift+X</em> +</dd> +</dl> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Draw Circles</title> +<link rel="previous" href="addText.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdDrawCurve.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdDrawCircle"></a>3.3.3.2 Draw Circles</h1> +<p> +Draw Circles +</p> +<dl><dd> +Draw circle outline from +<ul><li> +center to tangent point (Edge) - <em>Ctrl+Shift+0</em> +</li> +<li> +tangent point (Edge) to center - <em>Ctrl+Shift+9</em> +</li> +</ul> + +</dd> +</dl> +<p> + +</p> +<dl><dd> +Draw circle filled from +<ul><li> +center to tangent point (Edge) - <em>Ctrl+Alt+0</em> +</li> +<li> +tangent point (Edge) to center - <em>Ctrl+Alt+9</em> +</li> +</ul> + +</dd> +</dl> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Draw Curved Lines</title> +<link rel="previous" href="cmdDrawCircle.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdDrawShape.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdDrawCurve"></a>3.3.3.3 Draw Curved Lines</h1> +<p> +Draw Curved Lines +</p> +<dl><dd> +Draw curved lines from; +<ul><li> +center to endpoint - <em>Ctrl+Shift+6</em> +</li> +<li> +chord - <em>Ctrl+Shift+7</em> +</li> +<li> +endpoint in direction of curve - <em>Ctrl+Shift+4</em> +</li> +<li> +endpoint to center - <em>Ctrl+Shift+5</em> +</li> +</ul> + +</dd> +</dl> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Draw Shapes</title> +<link rel="previous" href="cmdDrawCurve.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdDrawStraight.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdDrawShape"></a>3.3.3.4 Draw Shapes</h1> +<p> +Draw Shapes +</p> +<dl><dd> +Draw shape +<ul><li> +Box outline - <em>Ctrl+Shift+[</em> +</li> +<li> +Filled Box - <em>Ctrl+Alt+[</em> +</li> +<li> +Filled Polygon - <em>Ctrl+Alt+2</em> +</li> +<li> +Poly-line - <em>Ctrl+Shift+2</em> +</li> +</ul> + +</dd> +</dl> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Draw Straight Objects</title> +<link rel="previous" href="cmdDrawShape.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="NoteDialog.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdDrawStraight"></a>3.3.3.5 Draw Straight Objects</h1> +<p> +Draw Straight Objects +</p> +<dl><dd> +Draw straight object +<ul><li> +<a name="i0"></a>Bench-work - <em>Ctrl+B</em> +</li> +<li> +Dimension Line - <em>Ctrl+Shift+D</em> +</li> +<li> +Straight Line - <em>Ctrl+Shift+1</em> +</li> +<li> +Table Edge - <em>Ctrl+Shift+)</em> +</li> +</ul> + +</dd> +</dl> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Note Dialog</title> +<link rel="previous" href="cmdDrawStraight.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdEdit.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="NoteDialog"></a>3.3.3.6 Note Dialog</h1> +<p> +Note Dialog +</p> +<dl><dd> +Note dialog (<a href="cmdNote.html#cmdNote">Section 2.3.3</a>) - <em>Ctrl+Alt+N</em> +</dd> +</dl> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Edit Commands</title> +<link rel="previous" href="NoteDialog.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdFile.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdEdit"></a>3.3.4 Edit Commands</h1> +<dl><dt> +Edit Commands +</dt> +</dl> +<p> + +</p> +<dl><dd> +Copy select objects to the clipboard - <em>Ctrl+C</em> or <em>Ctrl+Insert</em> +</dd> +</dl> +<p> + +</p> +<dl><dd> +Cut select objects - <em>Ctrl+X</em> or <em>Shift+Delete</em> +</dd> +</dl> +<p> + +</p> +<dl><dd> +Draw selected tracks with +<ul><li> +thin lines - <em>Ctrl+1</em> +</li> +<li> +medium lines - <em>Ctrl+2</em> +</li> +<li> +thick lines - <em>Ctrl+3</em> +</li> +</ul> +<p> + +</p> + +</dd> +<dd> +Delete selected object(s) - <em>Delete</em> or <em>Ctrl+D</em> +</dd> +</dl> +<p> + +</p> +<dl><dd> +Deselect all objects - <em>Alt+Shift+A</em> or <em>Esc</em> +</dd> +</dl> +<p> + +</p> +<dl><dd> +Hide selected tracks in a Tunnel - <em>Ctrl+Shift+T</em> +</dd> +</dl> +<p> + +</p> +<dl><dd> +Move Selected tracks +<ul><li> +above others - <em>Ctrl+Shift+B</em> +</li> +<li> +below others - <em>Ctrl+Shift+W</em> +</li> +</ul> +<p> + +</p> + +</dd> +<dd> +Paste from clipboard to layout - <em>Ctrl+V</em> or <em>Shift+Insert</em> +</dd> +</dl> +<p> + +</p> +<dl><dd> +Redo last undone command - <em>Ctrl+R</em> +</dd> +</dl> +<p> + +</p> +<dl><dd> +Select all objects - <em>Ctrl+Shift+A</em> +</dd> +</dl> +<p> + +</p> +<dl><dd> +Undo last command - <em>Ctrl+Z</em> or <em>Shift+Backspace</em> +</dd> +</dl> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>File Commands</title> +<link rel="previous" href="cmdEdit.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="kbshortcutHotBar.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdFile"></a>3.3.5 File Commands</h1> +<dl><dt> +File Commands +</dt> +</dl> +<p> + +</p> +<dl><dd> +Create a new layout - <em>Ctrl+N</em> +</dd> +</dl> +<p> + +</p> +<dl><dd> +Edit layout description Note (<a href="cmdNote.html#cmdNote">Section 2.3.3</a>) - <em>Ctrl+Alt+T</em> +</dd> +</dl> +<p> + +</p> +<dl><dd> +Export +<ul><li> +Selected objects to a <em>.xti</em> file - <em>Ctrl+Alt+X</em> +</li> +<li> +To Bitmap (<a href="cmdOutputbitmap.html#cmdOutputbitmap">Section 2.5.2</a>) - <em>Ctrl+Shift+Q</em> +</li> +</ul> +<p> + +</p> + +</dd> +<dd> +Import from a <em>.xti</em> file - <em>Ctrl+Alt+I</em> +</dd> +</dl> +<p> + +</p> +<dl><dd> +Manipulate Parameter Files (<a href="cmdPrmfile.html#cmdPrmfile">Section 2.5.7</a>) - <em>Ctrl+Alt+S</em> +</dd> +</dl> +<p> + +</p> +<dl><dd> +Open layout file - <em>Ctrl+O</em> +</dd> +</dl> +<p> + +</p> +<dl><dd> +Print Command (<a href="cmdPrint.html#cmdPrint">Section 2.5.9</a>) - <em>Ctrl+P</em> +</dd> +</dl> +<p> + +</p> +<dl><dd> +Save As another file - <em>Ctrl+A</em> +</dd> +</dl> +<p> + +</p> +<dl><dd> +Save the current layout - <em>Ctrl+S</em> +</dd> +</dl> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Hot Bar</title> +<link rel="previous" href="cmdFile.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdMacro.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="kbshortcutHotBar"></a>3.3.6 <a name="i0"></a>Hot Bar</h1> +<dl><dt> +Hot Bar +</dt> +</dl> +<p> + +</p> +<dl><dd> +These actions take effect if the Hot Bar has keyboard focus. +<ul><li> +Move Hot Bar multiple entries +<ul><li> +left - <em>Shift+Left Arrow</em> +</li> +<li> +right - <em>Shift+Right Arrow</em> +</li> +</ul> +<p> + +</p> + +</li> +<li> +Move Hot Bar one entry +<ul><li> +left - <em>Left Arrow</em> +</li> +<li> +right - <em>Right Arrow</em> +</li> +</ul> +<p> + +</p> + +</li> +<li> +Pop-up menu of Hot Bar categories - <em>Right-Click</em> +</li> +</ul> +<p> + +</p> +<ul><li> +Set relative position of Hot Bar - <em>1, 2 ... 9, 0</em> +</li> +</ul> + +</dd> +</dl> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Macro Commands</title> +<link rel="previous" href="kbshortcutHotBar.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="kbshortcutMainCanvas.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdMacro"></a>3.3.7 Macro Commands</h1> +<dl><dt> +Macro Commands +</dt> +</dl> +<p> + +</p> +<dl><dd> +Play Back a macro file (<a href="macroM.html#macroM">Section 2.8</a>) - <em>Ctrl+Alt+B</em> +</dd> +</dl> +<p> + +</p> +<dl><dd> +Record a macro file (<a href="macroM.html#macroM">Section 2.8</a>) - <em>Ctrl+Alt+R</em> +</dd> +</dl> +<p> + +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Main Drawing Canvas</title> +<link rel="previous" href="cmdMacro.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdManage.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="kbshortcutMainCanvas"></a>3.3.8 <a name="i0"></a>Main Drawing Canvas</h1> +<dl><dt> +Main Drawing Canvas +</dt> +</dl> +<p> + +</p> +<dl><dd> +These actions take effect if the Main Drawing Canvas has keyboard focus. +<p> + +</p> +<dl><dd> +Move Canvas: +<ul><li> +Down - <em>Down Arrow</em> +</li> +<li> +Left - <em>Left Arrow</em> +</li> +<li> +Right - <em>Right Arrow</em> +</li> +<li> +Up - <em>Up Arrow</em> +</li> +</ul> + +</dd> +</dl> +<p> + +</p> +<dl><dd> +Map Window: +<ul><li> +On / Off - <em>Ctrl+Space</em> +</li> +</ul> + +</dd> +</dl> + +</dd> +<dd> +On some systems support Three Button Mice, holding down the <em>Middle Mouse Button</em> and dragging will pan the Canvas. Note: not all system support this operation, even with a Three Button Mouse. +</dd> +</dl> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Manage Commands</title> +<link rel="previous" href="kbshortcutMainCanvas.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdOption.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdManage"></a>3.3.9 Manage Commands</h1> +<dl><dt> +Manage Commands +</dt> +</dl> +<p> + +</p> +<dl><dd> +Car Inventory dialog - <em>Ctrl+Alt+V</em> +</dd> +</dl> +<p> + +</p> +<dl><dd> +Custom Management dialog (<a href="cmdCustmgm.html#cmdCustmgm">Section 2.9.2</a>) - <em>Ctrl+Alt+U</em> +</dd> +</dl> +<p> + +</p> +<dl><dd> +Generate a Parts List (<a href="cmdEnum.html#cmdEnum">Section 2.9.6</a>) - <em>Ctrl+Alt+L</em> +</dd> +</dl> +<p> + +</p> +<dl><dd> +Group objects (<a href="cmdGroup.html#cmdGroup">Section 2.9.4</a>) - <em>Ctrl+Shift+G</em> +</dd> +</dl> +<p> + +</p> +<dl><dd> +Layers dialog (<a href="cmdLayer.html#cmdLayer">Section 2.9.5</a>) - <em>Ctrl+Alt+Y</em> +</dd> +</dl> +<p> + +</p> +<dl><dd> +Ungroup objects (<a href="cmdGroup.html#cmdGroup">Section 2.9.4</a>) - <em>Ctrl+Shift+U</em> +</dd> +</dl> +<p> + +</p> +<dl><dd> +Update Prices (<a href="cmdPricelist.html#cmdPricelist">Section 2.9.7</a>) - <em>Ctrl+Alt+Q</em> +</dd> +</dl> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Option Commands</title> +<link rel="previous" href="cmdManage.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdView.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdOption"></a>3.3.10 Option Commands</h1> +<dl><dt> +Options Commands +</dt> +</dl> +<p> + +</p> +<dl><dd> +Colors dialog (<a href="cmdRgbcolor.html#cmdRgbcolor">Section 2.10.1</a>) - <em>Ctrl+Alt+C</em> +</dd> +</dl> +<p> + +</p> +<dl><dd> +Command Options dialog (<a href="cmdCmdopt.html#cmdCmdopt">Section 2.10.2</a>) - <em>Ctrl+Alt+M</em> +</dd> +</dl> +<p> + +</p> +<dl><dd> +Display dialog (<a href="cmdDisplay.html#cmdDisplay">Section 2.10.3</a>) - <em>Ctrl+Alt+D</em> +</dd> +</dl> +<p> + +</p> +<dl><dd> +Easement Options dialog - <em>Ctrl+Alt+E</em> +</dd> +</dl> +<p> + +</p> +<dl><dd> +Font dialog (<a href="fontSelW.html#fontSelW">Section 2.10.5</a>) - <em>Ctrl+Alt+F</em> +</dd> +</dl> +<p> + +</p> +<dl><dd> +Layout dialog (<a href="cmdLayout.html#cmdLayout">Section 2.10.6</a>) - <em>Ctrl+Alt+A</em> +</dd> +</dl> +<p> + +</p> +<dl><dd> +Preferences dialog (<a href="cmdPref.html#cmdPref">Section 2.10.7</a>) - <em>Ctrl+Alt+P</em> +</dd> +</dl> +<p> + +</p> +<dl><dd> +Sticky commands dialog (<a href="cmdSticky.html#cmdSticky">Section 2.10.8</a>) - <em>Ctrl+Alt+K</em> +</dd> +</dl> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>View Commands</title> +<link rel="previous" href="cmdOption.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdAcclKeys.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdView"></a>3.3.11 View Commands</h1> +<dl><dt> +View Commands +</dt> +</dl> +<p> + +</p> +<dl><dd> +Redraw +<ul><li> +all - <em>Ctrl+Shift+L</em> +</li> +<li> +main window - <em>Ctrl+L</em> +</li> +</ul> + +</dd> +</dl> +<p> + +</p> +<dl><dd> +Snap Grid dialog (<a href="cmdGrid.html#cmdGrid">Section 2.12.2</a>) - <em>Ctrl+Alt+G</em> +</dd> +</dl> +<p> + +</p> +<dl><dd> +Zoom +<ul><li> +in - <em>Ctrl++, Page Down</em> +</li> +<li> +out - <em>Ctrl+-, Page Up</em> +</li> +</ul> + +</dd> +</dl> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Mouse Actions</title> +<link rel="previous" href="cmdView.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="mouseBcmd.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdAcclKeys"></a>3.4 <a name="i0"></a>Mouse Actions</h1> +<p> +<em>XTrackCAD</em> uses the left and right mouse buttons when manipulating tracks and other objects on the layout. Their meaning depends on the particular command: +</p> +<p> +<em>Select Command</em> +</p> +<p> +The <em>Select</em> command actions are affected by the mode selected in <strong>Options->Command->Select</strong>. Note - Objects in a Module Layer are selected and deselected as a group. +</p> +<dl><dt> +<em>Left-Click</em> +</dt> +<dd> +Single Item Mode -> Selects one object at a time, deselects other objects. Add Item Mode -> Adds unselected objects, deselects if the object is already selected. If the click is on an area without objects and <strong>SelectZero</strong> is set, all objects are deselected. +</dd> +<dt> +<em>Shift-Left-Click</em> +</dt> +<dd> +Selects all connected tracks from the one clicked up to the next selected item in each direction. +</dd> +<dt> +<em>Ctrl+Left-Click</em> +</dt> +<dd> +Single Item Mode -> Adds an object to the selection, deselects if the object is already selected. Add Item Mode -> Selects just this item and deselects other objects. If the click is on an area without objects and <strong>SelectZero</strong> is set, all objects are deselected. +</dd> +<dt> +<em>Double-Left-Click</em> +</dt> +<dd> +Opens Modify for Cornu and Draw Objects other than Text, Activates Link and Document Notes, otherwise opens Describe. +</dd> +<dt> +<em>Left+Drag</em> +</dt> +<dd> +Single Item Mode -> Selects all objects in an rubber-banded area and deselects all others. Add Item Mode -> Adds items in the rubber-banded area. +</dd> +<dt> +<em>Shift+Left-Drag</em> +</dt> +<dd> +Moves selected objects if in a selected area, if off selected objects, like Left-Drag. +</dd> +<dt> +<em>Ctrl+Left-Drag</em> +</dt> +<dd> +Rotates selected objects if in a selected area, if off selected objects, like Left-Drag. +</dd> +<dt> +<em>Right-Click</em> +</dt> +<dd> +Displays a pop-up menu of context commands (in Select, Move, Modify and Rotate commands). If some track is selected, the menu has operations to perform on it, if not, it will have a command context menu. +</dd> +<dt> +<em>Shift+Right-Click</em> +</dt> +<dd> +Displays a pop-up menu of commands. Displays the other context menu than Right-Click. +</dd> +<dt> +<em>Right+Drag</em> +</dt> +<dd> +Deselects all objects in an rubber-banded area from the current set. +</dd> +<dt> +<em>Rotate Wheel</em> +</dt> +<dd> +Zooms drawing area in and out. Modern computers with Trackpads often map this guesture to two-finger drag. +</dd> +</dl> +<p> +<em>When Moving and Rotating</em> ( Placing Turnouts and Structures, Moving the Print and Snap Grids, ... ): +</p> +<dl><dt> +<em>(Shift+Left+Drag)</em> +</dt> +<dd> +Moves the objects or grid. +</dd> +<dt> +<em>(Ctrl+Left+Drag)</em> +</dt> +<dd> +Rotates the objects or grid about the pivot point, which is the point you started the drag operation. +</dd> +</dl> +<p> +Some other commands use the <code>Shift</code> or <code>Ctrl</code> key to modify the meaning of button presses. +</p> +<hr> +<ul> +<li><a href="mouseBcmd.html#mouseBcmd">3.4.1 Context Sensitive Menus</a></li> +</ul> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Context Sensitive Menus</title> +<link rel="previous" href="cmdAcclKeys.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="faqs.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="mouseBcmd"></a>3.4.1 <a name="i0"></a>Context Sensitive Menus</h1> +<p> +For all commands listed below, a <em>Right-Click</em> will display a context sensitive pop-up command list menu. For some commands (noted below), a <em>Shift+Right-Click</em> will display a context sensitive pop-up command options menu. The operation of <em>Right-Click</em> and <em>Shift+Right-Click</em> can be reversed by an item on the Command Options (<a href="cmdCmdopt.html#cmdCmdopt">Section 2.10.2</a>) dialog. +</p> +<p> +The Shortcut key for each command is listed after the command name. +</p> +<dl><dt> +Circle Track Command (<a href="cmdCircle.html#cmdCircle">Section 2.1.1</a>) +</dt> +<dd> +Drag from +<ul><li> +center to circle tangent point (Edge) - <em>Ctrl+0</em> +</li> +<li> +circle tangent point (Edge) to center - <em>Ctrl+9</em> +</li> +</ul> + +</dd> +<dd> +Position fixed radius circle - <em>Ctrl+8</em> +</dd> +</dl> +<p> + +</p> +<dl><dt> +Connect Command (<a href="cmdConnect.html#cmdConnect">Section 2.2.3</a>) - <em>Ctrl+Shift+J</em> +</dt> +<dd> +Remove adjustments starting from an unconnected endpoint - <em>Shift+Left-Click</em> +</dd> +<dd> +Select endpoints to connect - <em>Left-Click</em> +</dd> +</dl> +<p> + +</p> +<dl><dt> +Curved Track Commands (<a href="cmdCurve.html#cmdCurve">Section 2.1.2</a>) +</dt> +<dd> +Drag from 1st endpoint +<ul><li> +in curve direction - <em>Ctrl+4</em> +</li> +<li> +to Center - <em>Ctrl+5</em> +</li> +<li> +to 2nd endpoint (Chord) - <em>Ctrl+7</em> +</li> +</ul> + +</dd> +<dd> +Drag from Center to 1st endpoint - <em>Ctrl+6</em> +</dd> +</dl> +<p> + +</p> +<dl><dt> +Properties Command (<a href="cmdDescribe.html#cmdDescribe">Section 2.2.13</a>) - <em>Ctrl+?</em> +</dt> +<dd> +Display property sheet for the object - <em>Left-Click</em> +</dd> +</dl> +<p> + +</p> +<dl><dt> +Elevation Command (<a href="cmdElevation.html#cmdElevation">Section 2.2.5</a>) - <em>Ctrl+Shift+E</em> +</dt> +<dd> +Choose endpoint - <em>Left-Click</em> +</dd> +<dd> +Move Elevation Marker - <em>Right+Drag</em> +</dd> +<dd> +Split track and choose endpoint - <em>Shift+Left-Click</em> +</dd> +</dl> +<p> + +</p> +<dl><dt> +Flip Command (<a href="cmdFlip.html#cmdFlip">Section 2.2.6</a>) +</dt> +<dd> +Draw Mirror line - <em>Left+Drag</em> +</dd> +</dl> +<p> + +</p> +<dl><dt> +Hand-laid Turnout Command (<a href="cmdHandLaidTurnout.html#cmdHandLaidTurnout">Section 2.1.3</a>) - <em>Ctrl+Shift+I</em> +</dt> +<dd> +Define +<ul><li> +frog position and angle - <em>(1st Left+Drag)</em> +</li> +<li> +points position - <em>(2nd Left+Drag)</em> +</li> +</ul> + +</dd> +</dl> +<p> + +</p> +<dl><dt> +Helix Track Command (<a href="cmdHelix.html#cmdHelix">Section 2.1.4</a>) - <em>Ctrl+Shift+H</em> +</dt> +<dd> +Position Helix - <em>(Left+Drag)</em> +</dd> +</dl> +<p> + +</p> +<dl><dt> +Join Command (<a href="cmdJoin.html#cmdJoin">Section 2.2.7</a>) - <em>Ctrl+J</em> +</dt> +<dd> +Join tracks - <em>(Left+Drag)</em> +</dd> +<dd> +Move selected tracks to join with unselected endpoint - <em>Shift+Left-Click</em> +</dd> +</dl> +<p> + +</p> +<dl><dt> +Modify Command (<a href="cmdModify.html#cmdModify">Section 2.2.8</a>) - <em>Ctrl+M</em> +</dt> +<dd> +Change +<ul><li> +length or make tangent to curve - <em>Left+Drag</em> +</li> +<li> +radius - <em>Shift+Left+Drag</em> +</li> +</ul> + +</dd> +<dd> +Extend track - <em>Right+Drag</em> +</dd> +</dl> +<p> + +</p> +<dl><dt> +Move Command (<a href="cmdMove.html#cmdMove">Section 2.2.9</a>) - <em>Ctrl+Shift+M</em> +</dt> +<dd> +Command Options: how to draw moving objects (<a href="cmdAcclKeys.html#cmdAcclKeys">Section 3.4</a>) - <em>Shift+Right-Click</em> +</dd> +<dd> +Move Selected objects - <em>Left+Drag</em> +</dd> +</dl> +<p> + +</p> +<dl><dt> +Move Description Command (<a href="cmdMoveLabel.html#cmdMoveLabel">Section 2.2.10</a>) - <em>Ctrl+Shift+Z</em> +</dt> +<dd> +Move Description - <em>Left+Drag</em> +</dd> +<dd> +Toggle Label display for Curved, Helix and Turnout tracks (<a href="cmdAcclKeys.html#cmdAcclKeys">Section 3.4</a>). - <em>Shift+Right-Click</em> +</dd> +</dl> +<p> + +</p> +<dl><dt> +Note Command (<a href="cmdNote.html#cmdNote">Section 2.3.3</a>) - <em>Ctrl+Alt+N</em> +</dt> +<dd> +Position Note - <em>Left+Drag</em> +</dd> +</dl> +<p> + +</p> +<dl><dt> +Parallel Command (<a href="cmdParallel.html#cmdParallel">Section 2.1.5</a>) - <em>Ctrl+Shift+P</em> +</dt> +<dd> +Position Parallel track relative to selected track - <em>(Left+Drag)</em> +</dd> +</dl> +<p> + +</p> +<dl><dt> +Print Command (<a href="cmdPrint.html#cmdPrint">Section 2.5.9</a>) - <em>Ctrl+P</em> +</dt> +<dd> +Command Options: rotate by specified amount (<a href="cmdAcclKeys.html#cmdAcclKeys">Section 3.4</a>) - <em>(Shift+Right-Click)</em> +</dd> +<dd> +Move Print grid - <em>Shift+Left+Drag</em> +</dd> +<dd> +Rotate Print grid - <em>Shift+Right+Drag</em> +</dd> +<dd> +Select or unselect pages - <em>Left-Click</em> +</dd> +</dl> +<p> + +</p> +<dl><dt> +Profile Command (<a href="cmdProfile.html#cmdProfile">Section 2.2.12</a>) - <em>Ctrl+Shift+F</em> +</dt> +<dd> +Add tracks to path from path end to chosen endpoint - <em>(Left-Click)</em> +</dd> +<dd> +Command Options: change Elevation type - <em>(Shift+Right-Click)</em> (<a href="cmdAcclKeys.html#cmdAcclKeys">Section 3.4</a>) +</dd> +</dl> +<p> + +</p> +<dl><dt> +Rotate Command (<a href="cmdRotate.html#cmdRotate">Section 2.2.15</a>) - <em>Ctrl+Shift+R</em> +</dt> +<dd> +Command Options: how to draw moving objects and rotate by specified amount (<a href="cmdAcclKeys.html#cmdAcclKeys">Section 3.4</a>) - <em>Shift+Right-Click</em> +</dd> +<dd> +Rotate Selected objects - <em>Left+Drag</em> +<ul><li> +in increments of 15° - <em>Ctrl+Left+Drag</em> +</li> +</ul> + +</dd> +</dl> +<p> + +</p> +<dl><dt> +Ruler Command (<a href="cmdRuler.html#cmdRuler">Section 2.3.4</a>) +</dt> +<dd> +Position Ruler - <em>Left+Drag</em> +</dd> +</dl> +<p> + +</p> +<dl><dt> +Angle Command (<a href="cmdAngle.html#cmdAngle">Section 2.3.5</a>) +</dt> +<dd> +Position Protractor - <em>Left-Drag</em> +</dd> +<dt> +Select Command (<a href="cmdSelect.html#cmdSelect">Section 2.2.16</a>) - <em>Ctrl+E</em> +</dt> +<dd> +Command Options: how to draw moving objects and rotate by specified amount (<a href="cmdAcclKeys.html#cmdAcclKeys">Section 3.4</a>) - <em>Shift+Right-Click</em> +</dd> +<dd> +Move +<ul><li> +selected objects - <em>Shift+Left+Drag</em> +</li> +<li> +labels - <em>Ctrl+Left+Drag</em> +</li> +</ul> + +</dd> +<dd> +Rotate selected objects - <em>Ctrl+Left-Drag</em> +<ul><li> +in increments of 15° - <em>Ctrl+Shift+Left+Drag</em> +</li> +</ul> + +</dd> +</dl> +<p> + +</p> +<dl><dt> +Snap Grid Command (<a href="cmdGrid.html#cmdGrid">Section 2.12.2</a>) - <em>Ctrl+Alt+G</em> +</dt> +<dd> +Command Options: rotate by specified amount (<a href="cmdAcclKeys.html#cmdAcclKeys">Section 3.4</a>) - <em>Shift+Right-Click</em> +</dd> +<dd> +Move Snap Grid - <em>Left+Drag</em> +</dd> +<dd> +Rotate Snap Grid - <em>Right+Drag</em> +</dd> +</dl> +<p> + +</p> +<dl><dt> +Split Track Command (<a href="cmdSplitTrack.html#cmdSplitTrack">Section 2.2.17.1</a>) - <em>Ctrl+Shift+S</em> +</dt> +<dd> +As above, plus trim turnouts - <em>Shift+Left-Click</em> +</dd> +<dd> +Change block gaps (<a href="cmdAcclKeys.html#cmdAcclKeys">Section 3.4</a>) - <em>Shift+Right-Click</em> +</dd> +<dd> +If at endpoint: disconnect track, otherwise: split track - <em>Left-Click</em> +</dd> +</dl> +<p> + +</p> +<dl><dt> +<a name="i1"></a>Straight Track Command (<a href="cmdStraight.html#cmdStraight">Section 2.1.6</a>) - <em>Ctrl+G</em> +</dt> +<dd> +Place 1st and 2nd endpoints - <em>Left+Drag</em> +</dd> +</dl> +<p> + +</p> +<dl><dt> +Structure Command (<a href="cmdStructure.html#cmdStructure">Section 2.1.7</a>) - <em>Ctrl+Shift+C</em> +</dt> +<dd> +Command Options: rotate by specified amount (<a href="cmdAcclKeys.html#cmdAcclKeys">Section 3.4</a>) - <em>Shift+Right-Click</em> +</dd> +<dd> +Place Structure - <em>Left+Drag</em> +</dd> +<dd> +Rotate - <em>Right+Drag</em> +</dd> +</dl> +<p> + +</p> +<dl><dt> +Text Command (<a href="cmdText.html#cmdText">Section 2.3.9</a>) - <em>Ctrl+Shift+X</em> +</dt> +<dd> +Command Options: change Font (<a href="cmdAcclKeys.html#cmdAcclKeys">Section 3.4</a>) - <em>Shift+Right-Click</em> +</dd> +<dd> +Position text - <em>Left+Drag</em> +</dd> +</dl> +<p> + +</p> +<dl><dt> +Train Simulation Command (<a href="cmdTrain.html#cmdTrain">Section 2.9.8</a>) +</dt> +<dd> +Command Options: uncouple car, flip or remove cars or Trains, set MU Master - <em>Right-Click</em> +</dd> +<dd> +Move a Car or Train - <em>Left+Drag</em> +</dd> +<dd> +Switch a <em>Turnout</em> or rotate a <em>Turntable</em> - <em>Shift+Left-Click</em> +</dd> +</dl> +<p> + +</p> +<dl><dt> +Turntable Command (<a href="cmdTurntable.html#cmdTurntable">Section 2.1.9</a>) - <em>Ctrl+Shift+N</em> +</dt> +<dd> +Position Turntable - <em>Left+Drag</em> +</dd> +</dl> +<p> + +</p> +<dl><dt> +Turnout Command (<a href="cmdNewFixedTrack.html#cmdNewFixedTrack">Section 2.1.8</a>) - <em>Ctrl+T</em> +</dt> +<dd> +Choose next Active endpoint when placing Turnouts - <em>Shift+Left-Click</em> +</dd> +<dd> +Command Options: rotate by specified amount (<a href="cmdAcclKeys.html#cmdAcclKeys">Section 3.4</a>) - <em>Shift+Right-Click</em> +</dd> +<dd> +Place Turnout - <em>Left+Drag</em> +</dd> +<dd> +Rotate - <em>Right+Drag</em> +</dd> +<dd> +Suppress auto-adjustment positioning when placing Turnouts - <em>Shift+Left+Drag</em> +</dd> +</dl> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Frequently Asked Questions</title> +<link rel="previous" href="mouseBcmd.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="faqsTransfer.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="faqs"></a>Appendix A: Frequently Asked Questions</h1> +<ul> +<li><a href="faqsTransfer.html#faqsTransfer">A.1 Moving from Design to Roadbed </a></li> +<li><a href="faqsHotBar.html#faqsHotBar">A.2 Hot Bar Items Missing!</a></li> +<li><a href="faqsPrototype.html#faqsPrototype">A.3 Unable to Add Cars to Inventory!</a></li> +<li><a href="faqsJoin.html#faqsJoin">A.4 How Do I Place and Join Tracks</a></li> +</ul> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Moving from Design to Roadbed </title> +<link rel="previous" href="faqs.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="faqsHotBar.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="faqsTransfer"></a>A.1 Moving from Design to Roadbed <a name="i0"></a></h1> +<p> +<strong>Your design is complete and your now ready to lay track. How do you go from the computer screen to the roadbed?</strong> +</p> +<p> +The best way to move your design from computer to roadbed is to print out a full scale copy (or portions) of the layout. During the print process the orientation of the print grid can be adjusted so the printout will line up with the tracks. +</p> +<p> +If you have cut-sheet printer (like a laser or ink-jet) set the Ignore Page Margins toggle on the print dialog. Normally there is an unprintable margin around the edge of the page and <em>XTrackCAD</em> only prints on the printable area, which means you would have to trim or overlay the pages. Setting the Ignore Page Margins toggle makes <em>XTrackCAD</em> ignore this margin so you can just abut the paper. Also, turn on Print Roadbed Outline and set your roadbed width. +</p> +<p> +For large scale printouts, the ability of many platforms to print as PDF is very helpful. Commercial printers can oftem print very large strips of paper. +</p> +<p> +Once you have a full scale print-out of your layout (or portion, if you have a larger layout you don't want to do it all at once) you need to transfer this to the roadbed. Here's two methods that can be used: +</p> +<ul><li> +Use a spray adhesive (such as 3M Super 77) to glue the print-out to the roadbed. This is very messy, takes more glue than expected and is very unforgiving of mistakes. You may want to use this method only for small sections of very complicated track-work. +</li> +</ul> +<p> + +</p> +<ul><li> +Tape the print-out to the roadbed then using a tracing wheel (available at Sewing shops), trace the center-line of the track and roadbed outline. At this point consider places when you'll want to widen the roadbed to support signals, switch machines, joints etc. +</li> +<li> +Some users have reported that they successfully used the DXF export to get a file into Computer Controlled Machines that can cut out trackbed. +</li> +</ul> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Hot Bar Items Missing!</title> +<link rel="previous" href="faqsTransfer.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="faqsPrototype.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="faqsHotBar"></a>A.2 Hot Bar Items Missing!</h1> +<p> +<strong>After installing XTrackCAD the Hot Bar is not active; the arrows to the left and the right of the Hot Bar are a grey colour instead of black, the Hot Bar is blank and also does not scroll.</strong> +</p> +<p> +There's nothing wrong, you just need to load a track or structure Parameter file. Open the <strong>Parameter dialog</strong> window (<strong>File>Parameter</strong>) then click on Browse. A list of <code>*.xtp</code> files with names like <code>atlasn55.xtp</code> should appear. Select whichever file or files are appropriate for your needs then click the OK button. Click OK on the Parameter File dialog and you should now have objects displayed on the Hot Bar. +</p> +<p> +Notes: +</p> +<ol><li> +Only elements that fit the selected scale are available in the Hot Bar. Thus if you're sure the parameter file has been loaded via the <strong>File>Parameter</strong> dialog, make sure the correct scale has been selected for the layout (<strong>Options>Layout</strong>). +<p> + +</p> + +</li> +<li> +If a long list of parameter files is selected, movement within the Hot Bar can be slow. If you right-click on the Hot Bar, a list of available parameter sets is shown. By <em>Left-Click</em>ing the desired parameter set, the Hot Bar is immediately scrolled to the first element in that parameter set. +<p> + +</p> + +</li> +<li> +When a new layout is created or when <em>XTrackCAD</em> is started for the first time, the scale of the layout defaults to N scale. Do not forget to change the scale in order to see tracks from other scales in the Hot Bar! +</li> +</ol> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Unable to Add Cars to Inventory!</title> +<link rel="previous" href="faqsHotBar.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="faqsJoin.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="faqsPrototype"></a>A.3 Unable to Add Cars to Inventory!</h1> +<p> +<strong>After installing</strong> <em>XTrackCAD</em> <strong>you're unable to add cars to the Car Inventory list; a message stating "No Car Prototypes are defined...." appears when you attempt to add cars to the Car Inventory list.</strong> +</p> +<p> +There's nothing wrong, you just need to load a Prototype definition file. +</p> +<p> +<em>XTrackCAD</em> includes a parameter file which defines many common North American Prototypes. The file is named <code>protoam.xtp</code>. It's loaded into <em>XTrackCAD</em> in the same way that a track, structure or car Parameter file would be loaded. +</p> +<ul><li> +Open the <strong>Parameter dialog</strong> window (<strong>File>Parameter</strong>) then click on Browse. Scroll through the list of <code>*.xtp</code> files to locate the file named <code>protoam.xtp</code>. Select this file then click the OK button. Click OK on the Parameter File dialog to complete installation of the prototype file. You should now be able to add cars to the Car Inventory list. +</li> +</ul> +<p> +Other prototype definitions can be created using the Car Prototype dialog. Refer to <a href="carprototype.html#carprototype">Section 2.9.1.3</a> for detail. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>How Do I Place and Join Tracks</title> +<link rel="previous" href="faqsPrototype.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="glossary.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="faqsJoin"></a>A.4 How Do I Place and Join Tracks</h1> +<p> +<strong>How do I join tracks, place turnouts, build a yard etc?</strong> +</p> +<p> +First take a look at the help file. Then try the demos (<strong>Help>Demos</strong> menu). This should answer a lot of questions on how to use <em>XTrackCAD</em>. Please visit <a href="http://www.xtrkcad.org/Wikka/HomePage" target="_blank">The XTrackCAD Wiki</a> if you need help, especially if you find the documentation unclear or think some area needs improvement. +</p> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Glossary</title> +<link rel="previous" href="faqsJoin.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="windowTerms.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="glossary"></a>Appendix B: Glossary</h1> +<p> +This section contains a helpful listing of Window and <em>XTrackCAD</em> terminology. +</p> +<hr> +<ul> +<li><a href="windowTerms.html#windowTerms">B.1 Window Terms</a></li> +<li><a href="generalTerms.html#generalTerms">B.2 XTrackCAD Terms</a></li> +<li><a href="controlElementScripts.html#controlElementScripts">B.3 Control Element Scripts and the Model RR System's Dispatcher</a></li> +</ul> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Window Terms</title> +<link rel="previous" href="glossary.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="generalTerms.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="windowTerms"></a>B.1 <a name="i0"></a>Window Terms</h1> +<p> +Menu and sub-menu items are indicated by <em>File>Open</em>, which means select the <em>File</em> menu and then select the <em>Open</em> menu item. +</p> +<p> +<strong>Balloon Help</strong> - short help message which is displayed as you move the mouse pointer over a control. +</p> +<p> +<strong>Canvas</strong> - an area within a window where objects are drawn. +</p> +<p> +<strong>Check Box</strong> - a button with a small square indicator to the left of its text. A check mark appears in the indicator when the button is selected. +</p> +<p> +<strong>Click</strong> - press and then release the left mouse button. +</p> +<p> +<strong>Drag</strong> - press and hold down the left mouse button and move the mouse to 'drag' the cursor on the screen. +</p> +<p> +<strong>Dialog</strong> - a type of window in which you input information. +</p> +<p> +<strong>Drop Down List</strong> - a list-box which is only displayed when you click on the 'drop-down' button. +</p> +<p> +<strong>Edit Box</strong> - an area where you can enter a String, Integer or Floating Point value. +</p> +<p> +<strong>Highlighted</strong> - an area on the Canvas which is in inverse-video. +</p> +<p> +<strong>Left-Click</strong> - same as <em>Click</em>, used in contexts where <em>Right-Click</em> is also used. +</p> +<p> +<strong>Left+Drag</strong> - same as <em>Drag</em>, used in contexts where <em>Right+Drag</em> is also used. +</p> +<p> +<strong>Mouse Pointer</strong> - is most often an arrow that is you can use to point at different objects on your screen. When the pointer is over an object, you can <em>Click</em> a mouse button to perform an action on that object (such as selecting the object). +</p> +<p> +<strong>Press</strong> - click on a button. +</p> +<p> +<strong>Radio Button</strong> - a button with a small round indicator to the left of its text. The indicator is filled when the button is selected. +</p> +<p> +<strong>Radio Button Group</strong> - a group of radio buttons which indicate mutually exclusive choices. +</p> +<p> +<strong>Resizing Border</strong> - a thick border around re-sizable windows that you can use to change the window size. +</p> +<p> +<strong>Right-Click</strong> - press and then release the right mouse button. +</p> +<p> +<strong>Right Drag</strong> - press and hold down the right mouse button and move the mouse to 'drag' the cursor on the screen. +</p> +<p> +<strong>Select</strong> - click on an object to indicate you want to do something with it. +</p> +<p> +<strong>Shift+Left-Click</strong> - <em>Left-Click</em> while holding down the <em>Shift</em> key. +</p> +<p> +<strong>Shift+Right-Click</strong> - <em>Right-Click</em> while holding down the <em>Shift</em> key. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>XTrackCAD Terms</title> +<link rel="previous" href="windowTerms.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="controlElementScripts.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="generalTerms"></a>B.2 <a name="i0"></a>XTrackCAD Terms</h1> +<p> +<strong>Active Endpoint</strong> - when placing a turnout, the endpoint which is used as a 'handle' when moved along other tracks. +</p> +<p> +<strong>Auto-connect</strong> - when placing turnouts (<a href="cmdHotBar.html#cmdHotBar">Section 2.7</a>) and creating parallel (<a href="cmdParallel.html#cmdParallel">Section 2.1.5</a>) tracks, the new track will automatically be connected to other tracks if the tracks are aligned properly. +</p> +<p> +<strong>Block Gap</strong> - provides control by dividing the layout into electrically isolated blocks, where trains can be slowed or stopped by lowering or cutting the power to a block. Dividing a layout into blocks also permits operators to run more than one train on a layout with much less risk of a fast train catching up with and hitting a slow train. Blocks can also trigger signals or other animated accessories on the layout, adding more realism (or whimsy) to the layout. Three-rail systems will often insulate one of the common rails on a section of track, and use a passing train to complete the circuit and activate an accessory. +</p> +<p> +<strong>Cornu</strong> - * Cornu curves are a family of mathematically defined curves that define spirals that Euler spirals and elastica come from. They have the useful property for us that curvature increases linearly along the curve which means the acceleration towards the center of the curve also increases evenly. Railways have long understood that smoothly changing the radius is key to passenger comfort and reduced derailments. The railway versions of these curves were variously called easements, Talbot or Euler spirals. +</p> +<p> +<strong>DXF Format</strong> - Abbreviation of <strong>D</strong>ata <strong>E</strong>xchange <strong>F</strong>ile, a two-dimensional graphics file format supported by virtually all PC-based CAD products. It was created by AutoDesk for the AutoCAD system. +</p> +<p> +<strong>Easement</strong> - special sections of gradually curving track used to connect straight and curved tracks (or two curved tracks). Easements reduce the effects of sudden changes in track curves which can cause derailments. They also look great! +</p> +<p> +<strong>Endpoint</strong> - One of the most important concepts in <em>XTrackCAD</em> is the endpoint. A piece of flex-track has an endpoint at each end. An endpoint has a position and an angle and it can be connected to other endpoints. The endpoints control where the track is placed and how it is connected. +</p> +<ul><li> +Turnouts have several endpoints (normally 3). +</li> +</ul> +<p> + +</p> +<ul><li> +Turntables have a varying number. +</li> +</ul> +<p> +<strong>Error Message</strong> - an error message displayed in the Status Bar (<a href="mainW.html#mainW">Section 3.1</a>) accompanied by a beep. +</p> +<p> +<a name="i1"></a><strong>Fixed-track</strong> - These include Turnouts, Sectional tracks and Grouped objects. They are defined in Parameter Files (<a href="cmdPrmfile.html#cmdPrmfile">Section 2.5.7</a>), or created using the <strong>Turnout Designer</strong> (<a href="cmdTurnoutNew.html#cmdTurnoutNew">Section 2.9.9</a>) or the <strong>Group</strong> (<a href="cmdGroup.html#cmdGroup">Section 2.9.4</a>) command. They are selected for placement on the layout using the <strong>Hot Bar</strong> (<a href="cmdHotBar.html#cmdHotBar">Section 2.7</a>) or the <strong>Fixed-Track</strong> (<a href="cmdNewFixedTrack.html#cmdNewFixedTrack">Section 2.1.8</a>) dialog. They can not be directly altered, but can be decomposed with the <strong>Ungroup</strong> (<a href="cmdUngroup.html#cmdUngroup">Section 2.9.11</a>) command and some cases trimed (<a href="splitDivide.html#splitDivide">Section 2.2.17.2.1</a>). +</p> +<p> +<a name="i2"></a><strong>Flex-track</strong> - Flexible sections of track used on a layout. It usually comes in straight, three-foot-long sections which can be bent or shaped as needed. These include Straight, Curved, Easements, Cornu and Bezier tracks. This term is also used for hand-laid track. They are created by invoking the corresponding command and dragging on the layout. <strong>Easements</strong> (<a href="cmdEasement.html#cmdEasement">Section 2.10.4</a>) are created automatically when joining tracks. +</p> +<p> +<strong>Frog</strong> - the place on a turnout track where one rail crosses the other. +</p> +<p> +<strong>Gauge</strong> - The distance between the inside of the heads of track rails. Most real railroads in North America and Europe are built to a standard gauge of 4'-8 1/2". Narrow gauge means rails with a width less than standard gauge. For example, On3 means O scale trains with three scale feet between the rails. +</p> +<p> +<strong>Handlaid</strong> - Track that's built with handmade ties, rail, and spikes. +</p> +<p> +<strong>Helix</strong> - A rising curve which turns around an axis like a corkscrew. Used on multilevel layouts to allow trains to go from one level to another. +</p> +<p> +<strong>Info Message</strong> - an informational message displayed in the Status Bar (<a href="mainW.html#mainW">Section 3.1</a>). +</p> +<p> +<strong>Object</strong> - an item on the layout, such as a track segment, table edge, line, note or text. +</p> +<p> +<strong>Points</strong> - the part of the Turnout that moves to select a path. +</p> +<p> +<strong>S-Curve</strong> - (aka <strong>Reverse Curve</strong>) a curve which bends in one direction and then the other, forming an S-like shape, without any appreciable length of straight track between the two curves +</p> +<p> +<strong>Sectional Track</strong> - prefabricated track which cannot be bent, split or changed. A type of <strong>Fixed-Track</strong>. +</p> +<p> +<strong>Selected Endpoint</strong> - when selecting track for various reasons the selected endpoint is the one closest to the selection point. +</p> +<p> +<strong>Tangent</strong> - A line, curve, or surface meeting another line, curve, or surface at a common point. +</p> +<p> +<strong>Track Segment</strong> - any piece of flex-track, turnout or sectional track. +</p> +<p> +<strong>Turnout</strong> - A piece of track that allows a train to go from one track to another. Called a switch on a real railroad. Referred to by number. For example, a no. 6 turnout spreads one unit for each six units of travel measured from the frog (the point at which two rails join to form a V). +</p> +<p> +Turnouts are a type of 'Fixed-track' which includes Sectional Tracks and Grouped Objects. +</p> +<ul><li> +In <em>XTrackCAD</em>, <em>Turnouts</em> also include sectional Tracks, crossings and forms of prefabricated (non-flex) track. +</li> +</ul> +<p> +<strong>Turnout Frog</strong> - the place on the turnout track where one rail crosses the other. +</p> +<p> +<strong>Turnout Number</strong> - the ratio of the number of units along the center line of a switch frog traversed for each unit the frog spreads to the sides. A No. 4 frog diverges 1 unit for every 4 it moves ahead; a No. 6, 1 for every 6 units. Although we usually refer to a turnout or switch number, in reality the measurement is for the frog. +</p> +<p> +<strong>Turnout Points</strong> - the part of the Turnout that moves to select a path. +</p> +<p> +<strong>Unconnected Endpoint</strong> - an endpoint which is not connected to another. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Control Element Scripts and the Model RR System's Dispatcher</title> +<link rel="previous" href="generalTerms.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="messages.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="controlElementScripts"></a>B.3 Control Element Scripts and the Model RR System's Dispatcher</h1> +<p> +Notes about control element scripts and the Model RR System's Dispatcher program in OpenLCB mode: +</p> +<p> +When using the Model RR System's Dispatcher program in OpenLCB mode to create CTC panels, the panel elements can have their LCC event IDs automatically populated from the information in the XTrackCAD file, if the proper syntax is observed. +</p> +<p> +A LCC event id is a 64-bit number, represented as eight pairs of hexadevimal digits (0-9, a-f/A-F) separated by periods (.). Each pair represents one 8-bit byte of the event id. This event id is either produced by a sensor or logic element or is consumed by a control/device or a logic element. +</p> +<p> +For blocks the occupency script contains a pair of LCC event ids, separated by a colon (:). The first LCC event id is produced by the occupency detector when the train enters the block and the second LCC event id is produced by the occupency detector when the train leaves the block. +</p> +<p> +For switchmotors the point sense script contains a pair of LCC event ids, separated by a colon (:). The first LCC event id is produced by the point sensor when the points are aligned in the "normal" position (typically aligned to the main) and the second LCC event id is produced by the point sensor when the points are aligned in the "reverse" position (typically aligned to the spur). The normal and reverse script each contain a signal LCC event id. These events are produced by the CTC Panel when the control point Code button is pressed (clicked) and are consumed by the switch motor. +</p> +<p> +For signals, the aspect name is a space separated list of the color(s) of the signal heads from top to bottom and the aspect script is a LCC event id that is consumed to produce that aspect. Presumably, the LCC event id is produced by a logic element (presumably a mast group in a Tower-LCC or similar device) or virtual track circuit in a Tower-LCC or similar device. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Messages and Explanations</title> +<link rel="previous" href="controlElementScripts.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="messageType.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="messages"></a>Appendix C: Messages and Explanations</h1> +<ul> +<li><a href="messageType.html#messageType">C.1 Message Types</a></li> +<li><a href="messageList.html#messageList">C.2 Message Explanations</a></li> +<ul> +<li><a href="MSG_HELIX_TURNS_GTR_0.html#MSG_HELIX_TURNS_GTR_0">C.2.1 A Helix must have one or more loops of track.</a></li> +<li><a href="MSG_SEL_TRK_FROZEN.html#MSG_SEL_TRK_FROZEN">C.2.2 A frozen layer contains selected track. Command cannot be executed.</a></li> +<li><a href="MSG_LARGE_FONT.html#MSG_LARGE_FONT">C.2.3 A large font has been selected....</a></li> +<li><a href="MSG_TODSGN_DESC_NONBLANK.html#MSG_TODSGN_DESC_NONBLANK">C.2.4 All description fields present in the Turnout...</a></li> +<li><a href="MSG_GROUP_NONBLANK.html#MSG_GROUP_NONBLANK">C.2.5 All fields listed in the Group dialog must contain data....</a></li> +<li><a href="MSG_TODSGN_VALUES_GTR_0.html#MSG_TODSGN_VALUES_GTR_0">C.2.6 All values specified in the Turnout Designer must be...</a></li> +<li><a href="MSG_CURVE_OUT_OF_RANGE.html#MSG_CURVE_OUT_OF_RANGE">C.2.7 Angle must be between 0° and 360°.</a></li> +<li><a href="MSG_CUSTMGM_DELETE_CONFIRM.html#MSG_CUSTMGM_DELETE_CONFIRM">C.2.8 Are you sure you want to delete the NNN definition(s)?</a></li> +<li><a href="MSG_WBITMAP_FAILED.html#MSG_WBITMAP_FAILED">C.2.9 Bitmap create or write function failed.</a></li> +<li><a href="MSG_BITMAP_TOO_LARGE.html#MSG_BITMAP_TOO_LARGE">C.2.10 Bitmap is too large.</a></li> +<li><a href="MSG_POLY_MULTIPLE_SELECTED.html#MSG_POLY_MULTIPLE_SELECTED">C.2.11 Can't delete multiple points at once</a></li> +<li><a href="MSG_GRID_ENABLE_SPACE_GTR_0.html#MSG_GRID_ENABLE_SPACE_GTR_0">C.2.12 Cannot Enable Grid; spacing must be greater than 0</a></li> +<li><a href="MSG_CANT_GROUP_BUMPER1.html#MSG_CANT_GROUP_BUMPER1">C.2.13 Cannot Group Bumper Track. The track has been unselected.</a></li> +<li><a href="MSG_CANNOT_GROUP_TRACK.html#MSG_CANNOT_GROUP_TRACK">C.2.14 Cannot Group selected track type %s.</a></li> +<li><a href="MSG_JOIN_NOTBEZIERORCORNU.html#MSG_JOIN_NOTBEZIERORCORNU">C.2.15 Cannot Join Bezier or Cornu track if Easement is not Cornu</a></li> +<li><a href="MSG_JOIN_EASEMENTS.html#MSG_JOIN_EASEMENTS">C.2.16 Cannot Join; Easements do not align or abut.</a></li> +<li><a href="MSG_JOIN_CORNU_SAME.html#MSG_JOIN_CORNU_SAME">C.2.17 Cannot Join; Selected endpoints are on same track.</a></li> +<li><a href="MSG_JOIN_SAME.html#MSG_JOIN_SAME">C.2.18 Cannot Join; Selected endpoints are on same track.</a></li> +<li><a href="MSG_SELECTED_TRACKS_PARALLEL.html#MSG_SELECTED_TRACKS_PARALLEL">C.2.19 Cannot Join; Selected tracks are parallel.</a></li> +<li><a href="MSG_GRID_SHOW_SPACE_GTR_0.html#MSG_GRID_SHOW_SPACE_GTR_0">C.2.20 Cannot Show Grid; spacing must be greater than 0</a></li> +<li><a href="MSG_CHANGE_ELEV_MODE.html#MSG_CHANGE_ELEV_MODE">C.2.21 Cannot change elevation mode.</a></li> +<li><a href="MSG_LAYER_FREEZE.html#MSG_LAYER_FREEZE">C.2.22 Cannot freeze current layer</a></li> +<li><a href="MSG_LAYER_HIDE.html#MSG_LAYER_HIDE">C.2.23 Cannot hide current layer</a></li> +<li><a href="MSG_JOIN_TURNTABLE.html#MSG_JOIN_TURNTABLE">C.2.24 Cannot join from a turntable, try to a turntable</a></li> +<li><a href="MSG_PRMFIL_OPEN_NEW.html#MSG_PRMFIL_OPEN_NEW">C.2.25 Cannot open New Parameter File: FILENAME</a></li> +<li><a href="MSG_LAYER_SEL_FROZEN.html#MSG_LAYER_SEL_FROZEN">C.2.26 Cannot select a frozen layer</a></li> +<li><a href="MSG_CANT_SPLIT_TRK.html#MSG_CANT_SPLIT_TRK">C.2.27 Cannot split TYPE track</a></li> +<li><a href="MSG_LAYER_MODULE.html#MSG_LAYER_MODULE">C.2.28 Cannot turn current layer into a Module</a></li> +<li><a href="MSG_CUSTMGM_CANT_WRITE.html#MSG_CUSTMGM_CANT_WRITE">C.2.29 Cannot write to parameter file: FILENAME</a></li> +<li><a href="MSG_CARIMP_DUP_INDEX.html#MSG_CARIMP_DUP_INDEX">C.2.30 Car Index number duplicated.</a></li> +<li><a href="MSG_CONN_PARAMS_TOO_BIG.html#MSG_CONN_PARAMS_TOO_BIG">C.2.31 Connection parameters reset to maximum values.</a></li> +<li><a href="MSG_CONN_PARAMS_TOO_SMALL.html#MSG_CONN_PARAMS_TOO_SMALL">C.2.32 Connection parameters reset to minimum values.</a></li> +<li><a href="MSG_CANT_PASTE.html#MSG_CANT_PASTE">C.2.33 Copy/Paste buffer is empty. There is nothing to Paste.</a></li> +<li><a href="MSG_PROG_CORRUPTED.html#MSG_PROG_CORRUPTED">C.2.34 Critical file damaged!...</a></li> +<li><a href="MSG_TODSGN_CROSSOVER_TOO_SHORT.html#MSG_TODSGN_CROSSOVER_TOO_SHORT">C.2.35 Crossover length is too short. Correct...</a></li> +<li><a href="MSG_CURVE_TOO_LARGE.html#MSG_CURVE_TOO_LARGE">C.2.36 Curved track is too large.</a></li> +<li><a href="MSG_TODSGN_REPLACE.html#MSG_TODSGN_REPLACE">C.2.37 Definition name is already in use. Saving this...</a></li> +<li><a href="MSG_SAVE_CHANGES.html#MSG_SAVE_CHANGES">C.2.38 Do you want to save the changes made to your Layout?</a></li> +<li><a href="MSG_CARIMP_DUP_COLUMNS.html#MSG_CARIMP_DUP_COLUMNS">C.2.39 Duplicate column headers found in Car Import file.</a></li> +<li><a href="MSG_EP_ON_PATH.html#MSG_EP_ON_PATH">C.2.40 Endpoint already on Path.</a></li> +<li><a href="MSG_UPGRADE_VERSION1.html#MSG_UPGRADE_VERSION1">C.2.41 File version %ld is greater than supported...</a></li> +<li><a href="MSG_UPGRADE_VERSION2.html#MSG_UPGRADE_VERSION2">C.2.42 File version %ld is greater than supported...</a></li> +<li><a href="MSG_PARAM_UPGRADE_VERSION1.html#MSG_PARAM_UPGRADE_VERSION1">C.2.43 File version %ld is greater than supported...</a></li> +<li><a href="MSG_PARAM_UPGRADE_VERSION2.html#MSG_PARAM_UPGRADE_VERSION2">C.2.44 File version %ld is greater than supported...</a></li> +<li><a href="MSG_TRK_ALREADY_CONN.html#MSG_TRK_ALREADY_CONN">C.2.45 First|Second track is already connected.</a></li> +<li><a href="MSG_MOVE_POINTS_OTHER_SIDE.html#MSG_MOVE_POINTS_OTHER_SIDE">C.2.46 Frog angle prevents placement of points. Move points to opposite side of frog.</a></li> +<li><a href="MSG_CANT_PLACE_FROGPOINTS.html#MSG_CANT_PLACE_FROGPOINTS">C.2.47 Frog|Points cannot be placed on a turnout, circle or helix.</a></li> +<li><a href="MSG_NO_ROOM_BTW_TRKS.html#MSG_NO_ROOM_BTW_TRKS">C.2.48 Insufficient space between existing stall tracks.</a></li> +<li><a href="MSG_JOIN_DIFFER_ELEV.html#MSG_JOIN_DIFFER_ELEV">C.2.49 Joining tracks with differing elevations (N.NNN)</a></li> +<li><a href="MSG_TRK_DESC_NOT_VISIBLE.html#MSG_TRK_DESC_NOT_VISIBLE">C.2.50 Label description is hidden</a></li> +<li><a href="MSG_DESC_NOT_VISIBLE.html#MSG_DESC_NOT_VISIBLE">C.2.51 Label descriptions not visible</a></li> +<li><a href="MSG_OBJECT_TOO_SHORT.html#MSG_OBJECT_TOO_SHORT">C.2.52 Length of object is too short.</a></li> +<li><a href="MSG_PRINT_MAX_SIZE.html#MSG_PRINT_MAX_SIZE">C.2.53 Maximum allowed page size is W x H</a></li> +<li><a href="MSG_PRMFIL_NO_CONTENTS.html#MSG_PRMFIL_NO_CONTENTS">C.2.54 New Parameter File has no CONTENTS line: FILENAME.</a></li> +<li><a href="MSG_NO_CARPROTO.html#MSG_NO_CARPROTO">C.2.55 No Car Prototypes are defined....</a></li> +<li><a href="MSG_NO_CARS.html#MSG_NO_CARS">C.2.56 No Cars are defined for the current scale....</a></li> +<li><a href="MSG_PRMFIL_NO_MAP.html#MSG_PRMFIL_NO_MAP">C.2.57 No Parameter File Map for CONTENTS</a></li> +<li><a href="MSG_GROUP_NO_PATHS.html#MSG_GROUP_NO_PATHS">C.2.58 No Paths were detected when grouping selected Tracks.</a></li> +<li><a href="MSG_POLY_NOTHING_SELECTED.html#MSG_POLY_NOTHING_SELECTED">C.2.59 No Point on a Poly shape selected.</a></li> +<li><a href="MSG_NO_TURNOUTS_AVAILABLE.html#MSG_NO_TURNOUTS_AVAILABLE">C.2.60 No Turnouts|Structures are available.</a></li> +<li><a href="MSG_CARIMP_NO_DATA.html#MSG_CARIMP_NO_DATA">C.2.61 No data present in Car Import file.</a></li> +<li><a href="MSG_NO_EMPTY_LAYER.html#MSG_NO_EMPTY_LAYER">C.2.62 No layer was found that has no contents, so the module can not be imported</a></li> +<li><a href="MSG_NO_UNFROZEN_LAYER.html#MSG_NO_UNFROZEN_LAYER">C.2.63 No layer was found that wasn't frozen. Layer 0 is unfrozen.</a></li> +<li><a href="MSG_PRINT_NO_PAGES.html#MSG_PRINT_NO_PAGES">C.2.64 No pages selected for printing.</a></li> +<li><a href="MSG_NO_PATH_TO_EP.html#MSG_NO_PATH_TO_EP">C.2.65 No path between Profile and selected endpoint.</a></li> +<li><a href="MSG_NO_SELECTED_TRK.html#MSG_NO_SELECTED_TRK">C.2.66 No track(s) selected!</a></li> +<li><a href="MSG_CARDESC_VALUE_ZERO.html#MSG_CARDESC_VALUE_ZERO">C.2.67 Numeric values on the Car Description...</a></li> +<li><a href="MSG_MOVE_OUT_OF_BOUNDS.html#MSG_MOVE_OUT_OF_BOUNDS">C.2.68 Object has moved beyond room boundaries.</a></li> +<li><a href="MSG_PARALLEL_SEP_GTR_0.html#MSG_PARALLEL_SEP_GTR_0">C.2.69 Parallel separation must be greater than 0, or the new guage must be different than the old.</a></li> +<li><a href="MSG_CARPART_DUPNAME.html#MSG_CARPART_DUPNAME">C.2.70 Part Number for this Manufacturer already exists....</a></li> +<li><a href="MSG_PLAYBACK_VERSION_UPGRADE.html#MSG_PLAYBACK_VERSION_UPGRADE">C.2.71 Playback file version %ld is...</a></li> +<li><a href="MSG_PLAYBACK_LISTENTRY.html#MSG_PLAYBACK_LISTENTRY">C.2.72 Playback: Cannot find list entry: NAME</a></li> +<li><a href="MSG_DOMOUSE_BAD_OP.html#MSG_DOMOUSE_BAD_OP">C.2.73 Playback: unknown action NNN</a></li> +<li><a href="MSG_NO_PRINTER_SELECTED.html#MSG_NO_PRINTER_SELECTED">C.2.74 Please select a printer from the Print Setup dialog.</a></li> +<li><a href="MSG_MOVE_POINTS_AWAY_CLOSE.html#MSG_MOVE_POINTS_AWAY_CLOSE">C.2.75 Points are to close to frog; move away.</a></li> +<li><a href="MSG_POLY_SHAPES_3_SIDES.html#MSG_POLY_SHAPES_3_SIDES">C.2.76 Polygons must have at least 3 nodes.</a></li> +<li><a href="MSG_CARPROTO_DUPNAME.html#MSG_CARPROTO_DUPNAME">C.2.77 Prototype name already exists....</a></li> +<li><a href="MSG_RADIUS_GTR_0.html#MSG_RADIUS_GTR_0">C.2.78 Radius must be greater than 0.</a></li> +<li><a href="MSG_RADIUS_GTR_10000.html#MSG_RADIUS_GTR_10000">C.2.79 Radius must be less than 10000.</a></li> +<li><a href="MSG_CARIMP_MISSING_COLUMNS.html#MSG_CARIMP_MISSING_COLUMNS">C.2.80 Required column headers missing from Car Import file.</a></li> +<li><a href="MSG_RESCALE_TOO_BIG.html#MSG_RESCALE_TOO_BIG">C.2.81 Rescaled tracks do not fit within layouts room parameters...</a></li> +<li><a href="MSG_BAD_SCALE_NAME.html#MSG_BAD_SCALE_NAME">C.2.82 Scale "SCALE1" is not valid. We will substitute a dummy scale based on "SCALE2". See 'Help|Recent Messages' for details.</a></li> +<li><a href="MSG_BAD_SCALE_INDEX.html#MSG_BAD_SCALE_INDEX">C.2.83 Scale index (NNN) is not valid. Do you want use the current layout scale (SCALE)? Or create an "Unknown" scale? See 'Help|Recent Messages' for details.</a></li> +<li><a href="MSG_2ND_TRK_NOT_SEL_UNSEL.html#MSG_2ND_TRK_NOT_SEL_UNSEL">C.2.84 Second track must be selected|unselected</a></li> +<li><a href="MSG_SEL_POS_FIRST.html#MSG_SEL_POS_FIRST">C.2.85 Select position prior to entering Text.</a></li> +<li><a href="MSG_OUT_OF_BOUNDS.html#MSG_OUT_OF_BOUNDS">C.2.86 Selected page is out of bounds.</a></li> +<li><a href="MSG_CARPROTO_BADSEGS.html#MSG_CARPROTO_BADSEGS">C.2.87 Selected shapes must define a rectangular area ...</a></li> +<li><a href="MSG_TOO_FAR_APART_DIVERGE.html#MSG_TOO_FAR_APART_DIVERGE">C.2.88 Selected tracks deviate too much or are too far apart from each other.</a></li> +<li><a href="MSG_COMMAND_DISABLED.html#MSG_COMMAND_DISABLED">C.2.89 Specified command disabled.</a></li> +<li><a href="MSG_SPLIT_POS_BTW_MERGEPTS.html#MSG_SPLIT_POS_BTW_MERGEPTS">C.2.90 Split position between Turnout Points</a></li> +<li><a href="MSG_SPLIT_PATH_NOT_UNIQUE.html#MSG_SPLIT_PATH_NOT_UNIQUE">C.2.91 Split position not on unique path</a></li> +<li><a href="MSG_RADIUS_TOO_BIG.html#MSG_RADIUS_TOO_BIG">C.2.92 The Circle or Helix will not fit within the layouts room parameters (Height and Width).</a></li> +<li><a href="MSG_NOT_UNFROZEN_LAYER.html#MSG_NOT_UNFROZEN_LAYER">C.2.93 The current layer was defined as frozen. It is now unfrozen.</a></li> +<li><a href="MSG_TODSGN_CORNU_TOO_COMPLEX.html#MSG_TODSGN_CORNU_TOO_COMPLEX">C.2.94 The curves created by the Turnout Designer for a cornu curve have more than 128 segments....</a></li> +<li><a href="MSG_ENTERED_STRING_TRUNCATED.html#MSG_ENTERED_STRING_TRUNCATED">C.2.95 The entered text is too long. Maximum length is %d.</a></li> +<li><a href="MSG_TEXT_TOO_LONG.html#MSG_TEXT_TOO_LONG">C.2.96 The entered text was too long for the text object. It was truncated.</a></li> +<li><a href="MSG_CARIMP_MISSING_PARTNO.html#MSG_CARIMP_MISSING_PARTNO">C.2.97 The following car has no Part Number...</a></li> +<li><a href="MSG_CARIMP_MISSING_DIMS.html#MSG_CARIMP_MISSING_DIMS">C.2.98 The following car has no dimensions and a...</a></li> +<li><a href="MSG_CARIMP_IGNORED_COLUMN.html#MSG_CARIMP_IGNORED_COLUMN">C.2.99 The following column in the Car Import file will be ignored:...</a></li> +<li><a href="MSG_CANT_MOVE_UNDER_TRAIN.html#MSG_CANT_MOVE_UNDER_TRAIN">C.2.100 The position of a turnout or turntable cannot be changed while occupied by a train.</a></li> +<li><a href="MSG_SPLITTED_OBJECT_TOO_SHORT.html#MSG_SPLITTED_OBJECT_TOO_SHORT">C.2.101 The resulting length of one track piece is shorter than the minimum length of %d.</a></li> +<li><a href="MSG_STRUCT_NO_STRUCTS.html#MSG_STRUCT_NO_STRUCTS">C.2.102 There are no structures to choose from in the structure...</a></li> +<li><a href="MSG_TURNOUT_NO_TURNOUT.html#MSG_TURNOUT_NO_TURNOUT">C.2.103 There are no turnouts to choose from in the turnout...</a></li> +<li><a href="MSG_NO_UNCONN_EP.html#MSG_NO_UNCONN_EP">C.2.104 There are no unconnected end points for this track</a></li> +<li><a href="MSG_PULL_FEW_SECTIONS.html#MSG_PULL_FEW_SECTIONS">C.2.105 There are too few sections in this loop.</a></li> +<li><a href="MSG_NO_REDO.html#MSG_NO_REDO">C.2.106 There is nothing to redo!</a></li> +<li><a href="MSG_NO_UNDO.html#MSG_NO_UNDO">C.2.107 There is nothing to undo!</a></li> +<li><a href="MSG_TOOMANYSEGSINGROUP.html#MSG_TOOMANYSEGSINGROUP">C.2.108 Too many track segments in Group.</a></li> +<li><a href="MSG_CANNOT_CHANGE.html#MSG_CANNOT_CHANGE">C.2.109 Track cannot be changed.</a></li> +<li><a href="MSG_POINT_INSIDE_TURNTABLE.html#MSG_POINT_INSIDE_TURNTABLE">C.2.110 Track endpoint is within turntable radius.</a></li> +<li><a href="MSG_MOVE_POINTS_AWAY_NO_INTERSECTION.html#MSG_MOVE_POINTS_AWAY_NO_INTERSECTION">C.2.111 Track intersection not possible; move points away from frog.</a></li> +<li><a href="MSG_TRK_TOO_SHORT.html#MSG_TRK_TOO_SHORT">C.2.112 Track is too short by N.NNN</a></li> +<li><a href="MSG_RADIUS_LSS_EASE_MIN.html#MSG_RADIUS_LSS_EASE_MIN">C.2.113 Track radius (N.NNN) is smaller than easement minimum (N.NNN).</a></li> +<li><a href="MSG_SEGMENT_NOT_ON_PATH.html#MSG_SEGMENT_NOT_ON_PATH">C.2.114 Track segment N not on Path for Turnout</a></li> +<li><a href="MSG_TOOMANYSEGSINGROUP2.html#MSG_TOOMANYSEGSINGROUP2">C.2.115 Track segments appear too late in Group segment list.</a></li> +<li><a href="MSG_CANT_MODIFY_FROZEN_TRK.html#MSG_CANT_MODIFY_FROZEN_TRK">C.2.116 Tracks in a frozen layer cannot be modified.</a></li> +<li><a href="MSG_CANT_MODIFY_MODULE_TRK.html#MSG_CANT_MODIFY_MODULE_TRK">C.2.117 Tracks in a module cannot be modified.</a></li> +<li><a href="MSG_SEGMENTS_DIFFER.html#MSG_SEGMENTS_DIFFER">C.2.118 Turnout definition contains non-track segments....</a></li> +<li><a href="MSG_TURNTABLE_DIAM_GTR_0.html#MSG_TURNTABLE_DIAM_GTR_0">C.2.119 Turntable diameter must greater than 0.</a></li> +<li><a href="MSG_UNDO_ASSERT.html#MSG_UNDO_ASSERT">C.2.120 Undo assertion failure %s:%d...</a></li> +<li><a href="MSG_LAYOUT_LINES_SKIPPED.html#MSG_LAYOUT_LINES_SKIPPED">C.2.121 While processing Layout file %s, %d lines were skipped because they were not recognized.</a></li> +<li><a href="MSG_PARAM_LINES_SKIPPED.html#MSG_PARAM_LINES_SKIPPED">C.2.122 While processing Parameter file %s, %d lines were skipped because they were not recognized.</a></li> +<li><a href="MSG_BETA_NOTICE.html#MSG_BETA_NOTICE">C.2.123 XTrackCAD Version %s: Please note that this Beta Version of XTrackCAD is still undergoing final testing before its official release. The sole purpose of this Beta Version is to conduct testing and obtain feedback. Should you encounter any bugs, glitches, lack of functionality or other problems, please let us know immediately so we can rectify these accordingly. Your help in this regard is greatly appreciated!</a></li> +<li><a href="MSG_BITMAP_SIZE_WARNING.html#MSG_BITMAP_SIZE_WARNING">C.2.124 You have specified a large bitmap....</a></li> +<li><a href="MSG_PT_IS_NOT_TRK.html#MSG_PT_IS_NOT_TRK">C.2.125 [X Y] is not a track</a></li> +</ul> +</ul> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Message Types</title> +<link rel="previous" href="messages.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="messageList.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="messageType"></a>C.1 <a name="i0"></a>Message Types</h1> +<p> +<em>XTrackCAD</em> generates three types of messages: +</p> +<dl><dd> +<em>Notices</em>, which appear in their own window and require you to press a button to make a choice or dismiss them. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<em>Error messages</em>, which appear in the <strong>Status-bar</strong> (<a href="mainW.html#mainW">Section 3.1</a>) and are accompanied by a beep. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<em>Information messages</em>, which appear in the <strong>Status-bar</strong> (<a href="mainW.html#mainW">Section 3.1</a>) without a beep. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<em>Notices</em> and <em>Error messages</em> that might be encountered are listed here with a explanation. The <strong>Recent Messages</strong> menu item on the <strong>Help</strong> (<a href="helpM.html#helpM">Section 2.6</a>) menu contains a list of the most recent messages. Selecting one of the entries presents information on the particular message. +</dd> +</dl> +<p> + +</p> +<dl><dd> +The notation <em>abc|xyx</em> indicates the message can appear with either of the values (<em>abc</em> or <em>xyz</em>). Items in <em>UPPERCASE</em> indicate numeric (such as lengths) or string (such as filenames) values. +</dd> +</dl> +<p> +<a href="messageList.html#messageList">Section C.2</a> provides detail explanation of each information or error message. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Message Explanations</title> +<link rel="previous" href="messageType.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_HELIX_TURNS_GTR_0.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="messageList"></a>C.2 Message Explanations</h1> +<ul> +<li><a href="MSG_HELIX_TURNS_GTR_0.html#MSG_HELIX_TURNS_GTR_0">C.2.1 A Helix must have one or more loops of track.</a></li> +<li><a href="MSG_SEL_TRK_FROZEN.html#MSG_SEL_TRK_FROZEN">C.2.2 A frozen layer contains selected track. Command cannot be executed.</a></li> +<li><a href="MSG_LARGE_FONT.html#MSG_LARGE_FONT">C.2.3 A large font has been selected....</a></li> +<li><a href="MSG_TODSGN_DESC_NONBLANK.html#MSG_TODSGN_DESC_NONBLANK">C.2.4 All description fields present in the Turnout...</a></li> +<li><a href="MSG_GROUP_NONBLANK.html#MSG_GROUP_NONBLANK">C.2.5 All fields listed in the Group dialog must contain data....</a></li> +<li><a href="MSG_TODSGN_VALUES_GTR_0.html#MSG_TODSGN_VALUES_GTR_0">C.2.6 All values specified in the Turnout Designer must be...</a></li> +<li><a href="MSG_CURVE_OUT_OF_RANGE.html#MSG_CURVE_OUT_OF_RANGE">C.2.7 Angle must be between 0° and 360°.</a></li> +<li><a href="MSG_CUSTMGM_DELETE_CONFIRM.html#MSG_CUSTMGM_DELETE_CONFIRM">C.2.8 Are you sure you want to delete the NNN definition(s)?</a></li> +<li><a href="MSG_WBITMAP_FAILED.html#MSG_WBITMAP_FAILED">C.2.9 Bitmap create or write function failed.</a></li> +<li><a href="MSG_BITMAP_TOO_LARGE.html#MSG_BITMAP_TOO_LARGE">C.2.10 Bitmap is too large.</a></li> +<li><a href="MSG_POLY_MULTIPLE_SELECTED.html#MSG_POLY_MULTIPLE_SELECTED">C.2.11 Can't delete multiple points at once</a></li> +<li><a href="MSG_GRID_ENABLE_SPACE_GTR_0.html#MSG_GRID_ENABLE_SPACE_GTR_0">C.2.12 Cannot Enable Grid; spacing must be greater than 0</a></li> +<li><a href="MSG_CANT_GROUP_BUMPER1.html#MSG_CANT_GROUP_BUMPER1">C.2.13 Cannot Group Bumper Track. The track has been unselected.</a></li> +<li><a href="MSG_CANNOT_GROUP_TRACK.html#MSG_CANNOT_GROUP_TRACK">C.2.14 Cannot Group selected track type %s.</a></li> +<li><a href="MSG_JOIN_NOTBEZIERORCORNU.html#MSG_JOIN_NOTBEZIERORCORNU">C.2.15 Cannot Join Bezier or Cornu track if Easement is not Cornu</a></li> +<li><a href="MSG_JOIN_EASEMENTS.html#MSG_JOIN_EASEMENTS">C.2.16 Cannot Join; Easements do not align or abut.</a></li> +<li><a href="MSG_JOIN_CORNU_SAME.html#MSG_JOIN_CORNU_SAME">C.2.17 Cannot Join; Selected endpoints are on same track.</a></li> +<li><a href="MSG_JOIN_SAME.html#MSG_JOIN_SAME">C.2.18 Cannot Join; Selected endpoints are on same track.</a></li> +<li><a href="MSG_SELECTED_TRACKS_PARALLEL.html#MSG_SELECTED_TRACKS_PARALLEL">C.2.19 Cannot Join; Selected tracks are parallel.</a></li> +<li><a href="MSG_GRID_SHOW_SPACE_GTR_0.html#MSG_GRID_SHOW_SPACE_GTR_0">C.2.20 Cannot Show Grid; spacing must be greater than 0</a></li> +<li><a href="MSG_CHANGE_ELEV_MODE.html#MSG_CHANGE_ELEV_MODE">C.2.21 Cannot change elevation mode.</a></li> +<li><a href="MSG_LAYER_FREEZE.html#MSG_LAYER_FREEZE">C.2.22 Cannot freeze current layer</a></li> +<li><a href="MSG_LAYER_HIDE.html#MSG_LAYER_HIDE">C.2.23 Cannot hide current layer</a></li> +<li><a href="MSG_JOIN_TURNTABLE.html#MSG_JOIN_TURNTABLE">C.2.24 Cannot join from a turntable, try to a turntable</a></li> +<li><a href="MSG_PRMFIL_OPEN_NEW.html#MSG_PRMFIL_OPEN_NEW">C.2.25 Cannot open New Parameter File: FILENAME</a></li> +<li><a href="MSG_LAYER_SEL_FROZEN.html#MSG_LAYER_SEL_FROZEN">C.2.26 Cannot select a frozen layer</a></li> +<li><a href="MSG_CANT_SPLIT_TRK.html#MSG_CANT_SPLIT_TRK">C.2.27 Cannot split TYPE track</a></li> +<li><a href="MSG_LAYER_MODULE.html#MSG_LAYER_MODULE">C.2.28 Cannot turn current layer into a Module</a></li> +<li><a href="MSG_CUSTMGM_CANT_WRITE.html#MSG_CUSTMGM_CANT_WRITE">C.2.29 Cannot write to parameter file: FILENAME</a></li> +<li><a href="MSG_CARIMP_DUP_INDEX.html#MSG_CARIMP_DUP_INDEX">C.2.30 Car Index number duplicated.</a></li> +<li><a href="MSG_CONN_PARAMS_TOO_BIG.html#MSG_CONN_PARAMS_TOO_BIG">C.2.31 Connection parameters reset to maximum values.</a></li> +<li><a href="MSG_CONN_PARAMS_TOO_SMALL.html#MSG_CONN_PARAMS_TOO_SMALL">C.2.32 Connection parameters reset to minimum values.</a></li> +<li><a href="MSG_CANT_PASTE.html#MSG_CANT_PASTE">C.2.33 Copy/Paste buffer is empty. There is nothing to Paste.</a></li> +<li><a href="MSG_PROG_CORRUPTED.html#MSG_PROG_CORRUPTED">C.2.34 Critical file damaged!...</a></li> +<li><a href="MSG_TODSGN_CROSSOVER_TOO_SHORT.html#MSG_TODSGN_CROSSOVER_TOO_SHORT">C.2.35 Crossover length is too short. Correct...</a></li> +<li><a href="MSG_CURVE_TOO_LARGE.html#MSG_CURVE_TOO_LARGE">C.2.36 Curved track is too large.</a></li> +<li><a href="MSG_TODSGN_REPLACE.html#MSG_TODSGN_REPLACE">C.2.37 Definition name is already in use. Saving this...</a></li> +<li><a href="MSG_SAVE_CHANGES.html#MSG_SAVE_CHANGES">C.2.38 Do you want to save the changes made to your Layout?</a></li> +<li><a href="MSG_CARIMP_DUP_COLUMNS.html#MSG_CARIMP_DUP_COLUMNS">C.2.39 Duplicate column headers found in Car Import file.</a></li> +<li><a href="MSG_EP_ON_PATH.html#MSG_EP_ON_PATH">C.2.40 Endpoint already on Path.</a></li> +<li><a href="MSG_UPGRADE_VERSION1.html#MSG_UPGRADE_VERSION1">C.2.41 File version %ld is greater than supported...</a></li> +<li><a href="MSG_UPGRADE_VERSION2.html#MSG_UPGRADE_VERSION2">C.2.42 File version %ld is greater than supported...</a></li> +<li><a href="MSG_PARAM_UPGRADE_VERSION1.html#MSG_PARAM_UPGRADE_VERSION1">C.2.43 File version %ld is greater than supported...</a></li> +<li><a href="MSG_PARAM_UPGRADE_VERSION2.html#MSG_PARAM_UPGRADE_VERSION2">C.2.44 File version %ld is greater than supported...</a></li> +<li><a href="MSG_TRK_ALREADY_CONN.html#MSG_TRK_ALREADY_CONN">C.2.45 First|Second track is already connected.</a></li> +<li><a href="MSG_MOVE_POINTS_OTHER_SIDE.html#MSG_MOVE_POINTS_OTHER_SIDE">C.2.46 Frog angle prevents placement of points. Move points to opposite side of frog.</a></li> +<li><a href="MSG_CANT_PLACE_FROGPOINTS.html#MSG_CANT_PLACE_FROGPOINTS">C.2.47 Frog|Points cannot be placed on a turnout, circle or helix.</a></li> +<li><a href="MSG_NO_ROOM_BTW_TRKS.html#MSG_NO_ROOM_BTW_TRKS">C.2.48 Insufficient space between existing stall tracks.</a></li> +<li><a href="MSG_JOIN_DIFFER_ELEV.html#MSG_JOIN_DIFFER_ELEV">C.2.49 Joining tracks with differing elevations (N.NNN)</a></li> +<li><a href="MSG_TRK_DESC_NOT_VISIBLE.html#MSG_TRK_DESC_NOT_VISIBLE">C.2.50 Label description is hidden</a></li> +<li><a href="MSG_DESC_NOT_VISIBLE.html#MSG_DESC_NOT_VISIBLE">C.2.51 Label descriptions not visible</a></li> +<li><a href="MSG_OBJECT_TOO_SHORT.html#MSG_OBJECT_TOO_SHORT">C.2.52 Length of object is too short.</a></li> +<li><a href="MSG_PRINT_MAX_SIZE.html#MSG_PRINT_MAX_SIZE">C.2.53 Maximum allowed page size is W x H</a></li> +<li><a href="MSG_PRMFIL_NO_CONTENTS.html#MSG_PRMFIL_NO_CONTENTS">C.2.54 New Parameter File has no CONTENTS line: FILENAME.</a></li> +<li><a href="MSG_NO_CARPROTO.html#MSG_NO_CARPROTO">C.2.55 No Car Prototypes are defined....</a></li> +<li><a href="MSG_NO_CARS.html#MSG_NO_CARS">C.2.56 No Cars are defined for the current scale....</a></li> +<li><a href="MSG_PRMFIL_NO_MAP.html#MSG_PRMFIL_NO_MAP">C.2.57 No Parameter File Map for CONTENTS</a></li> +<li><a href="MSG_GROUP_NO_PATHS.html#MSG_GROUP_NO_PATHS">C.2.58 No Paths were detected when grouping selected Tracks.</a></li> +<li><a href="MSG_POLY_NOTHING_SELECTED.html#MSG_POLY_NOTHING_SELECTED">C.2.59 No Point on a Poly shape selected.</a></li> +<li><a href="MSG_NO_TURNOUTS_AVAILABLE.html#MSG_NO_TURNOUTS_AVAILABLE">C.2.60 No Turnouts|Structures are available.</a></li> +<li><a href="MSG_CARIMP_NO_DATA.html#MSG_CARIMP_NO_DATA">C.2.61 No data present in Car Import file.</a></li> +<li><a href="MSG_NO_EMPTY_LAYER.html#MSG_NO_EMPTY_LAYER">C.2.62 No layer was found that has no contents, so the module can not be imported</a></li> +<li><a href="MSG_NO_UNFROZEN_LAYER.html#MSG_NO_UNFROZEN_LAYER">C.2.63 No layer was found that wasn't frozen. Layer 0 is unfrozen.</a></li> +<li><a href="MSG_PRINT_NO_PAGES.html#MSG_PRINT_NO_PAGES">C.2.64 No pages selected for printing.</a></li> +<li><a href="MSG_NO_PATH_TO_EP.html#MSG_NO_PATH_TO_EP">C.2.65 No path between Profile and selected endpoint.</a></li> +<li><a href="MSG_NO_SELECTED_TRK.html#MSG_NO_SELECTED_TRK">C.2.66 No track(s) selected!</a></li> +<li><a href="MSG_CARDESC_VALUE_ZERO.html#MSG_CARDESC_VALUE_ZERO">C.2.67 Numeric values on the Car Description...</a></li> +<li><a href="MSG_MOVE_OUT_OF_BOUNDS.html#MSG_MOVE_OUT_OF_BOUNDS">C.2.68 Object has moved beyond room boundaries.</a></li> +<li><a href="MSG_PARALLEL_SEP_GTR_0.html#MSG_PARALLEL_SEP_GTR_0">C.2.69 Parallel separation must be greater than 0, or the new guage must be different than the old.</a></li> +<li><a href="MSG_CARPART_DUPNAME.html#MSG_CARPART_DUPNAME">C.2.70 Part Number for this Manufacturer already exists....</a></li> +<li><a href="MSG_PLAYBACK_VERSION_UPGRADE.html#MSG_PLAYBACK_VERSION_UPGRADE">C.2.71 Playback file version %ld is...</a></li> +<li><a href="MSG_PLAYBACK_LISTENTRY.html#MSG_PLAYBACK_LISTENTRY">C.2.72 Playback: Cannot find list entry: NAME</a></li> +<li><a href="MSG_DOMOUSE_BAD_OP.html#MSG_DOMOUSE_BAD_OP">C.2.73 Playback: unknown action NNN</a></li> +<li><a href="MSG_NO_PRINTER_SELECTED.html#MSG_NO_PRINTER_SELECTED">C.2.74 Please select a printer from the Print Setup dialog.</a></li> +<li><a href="MSG_MOVE_POINTS_AWAY_CLOSE.html#MSG_MOVE_POINTS_AWAY_CLOSE">C.2.75 Points are to close to frog; move away.</a></li> +<li><a href="MSG_POLY_SHAPES_3_SIDES.html#MSG_POLY_SHAPES_3_SIDES">C.2.76 Polygons must have at least 3 nodes.</a></li> +<li><a href="MSG_CARPROTO_DUPNAME.html#MSG_CARPROTO_DUPNAME">C.2.77 Prototype name already exists....</a></li> +<li><a href="MSG_RADIUS_GTR_0.html#MSG_RADIUS_GTR_0">C.2.78 Radius must be greater than 0.</a></li> +<li><a href="MSG_RADIUS_GTR_10000.html#MSG_RADIUS_GTR_10000">C.2.79 Radius must be less than 10000.</a></li> +<li><a href="MSG_CARIMP_MISSING_COLUMNS.html#MSG_CARIMP_MISSING_COLUMNS">C.2.80 Required column headers missing from Car Import file.</a></li> +<li><a href="MSG_RESCALE_TOO_BIG.html#MSG_RESCALE_TOO_BIG">C.2.81 Rescaled tracks do not fit within layouts room parameters...</a></li> +<li><a href="MSG_BAD_SCALE_NAME.html#MSG_BAD_SCALE_NAME">C.2.82 Scale "SCALE1" is not valid. We will substitute a dummy scale based on "SCALE2". See 'Help|Recent Messages' for details.</a></li> +<li><a href="MSG_BAD_SCALE_INDEX.html#MSG_BAD_SCALE_INDEX">C.2.83 Scale index (NNN) is not valid. Do you want use the current layout scale (SCALE)? Or create an "Unknown" scale? See 'Help|Recent Messages' for details.</a></li> +<li><a href="MSG_2ND_TRK_NOT_SEL_UNSEL.html#MSG_2ND_TRK_NOT_SEL_UNSEL">C.2.84 Second track must be selected|unselected</a></li> +<li><a href="MSG_SEL_POS_FIRST.html#MSG_SEL_POS_FIRST">C.2.85 Select position prior to entering Text.</a></li> +<li><a href="MSG_OUT_OF_BOUNDS.html#MSG_OUT_OF_BOUNDS">C.2.86 Selected page is out of bounds.</a></li> +<li><a href="MSG_CARPROTO_BADSEGS.html#MSG_CARPROTO_BADSEGS">C.2.87 Selected shapes must define a rectangular area ...</a></li> +<li><a href="MSG_TOO_FAR_APART_DIVERGE.html#MSG_TOO_FAR_APART_DIVERGE">C.2.88 Selected tracks deviate too much or are too far apart from each other.</a></li> +<li><a href="MSG_COMMAND_DISABLED.html#MSG_COMMAND_DISABLED">C.2.89 Specified command disabled.</a></li> +<li><a href="MSG_SPLIT_POS_BTW_MERGEPTS.html#MSG_SPLIT_POS_BTW_MERGEPTS">C.2.90 Split position between Turnout Points</a></li> +<li><a href="MSG_SPLIT_PATH_NOT_UNIQUE.html#MSG_SPLIT_PATH_NOT_UNIQUE">C.2.91 Split position not on unique path</a></li> +<li><a href="MSG_RADIUS_TOO_BIG.html#MSG_RADIUS_TOO_BIG">C.2.92 The Circle or Helix will not fit within the layouts room parameters (Height and Width).</a></li> +<li><a href="MSG_NOT_UNFROZEN_LAYER.html#MSG_NOT_UNFROZEN_LAYER">C.2.93 The current layer was defined as frozen. It is now unfrozen.</a></li> +<li><a href="MSG_TODSGN_CORNU_TOO_COMPLEX.html#MSG_TODSGN_CORNU_TOO_COMPLEX">C.2.94 The curves created by the Turnout Designer for a cornu curve have more than 128 segments....</a></li> +<li><a href="MSG_ENTERED_STRING_TRUNCATED.html#MSG_ENTERED_STRING_TRUNCATED">C.2.95 The entered text is too long. Maximum length is %d.</a></li> +<li><a href="MSG_TEXT_TOO_LONG.html#MSG_TEXT_TOO_LONG">C.2.96 The entered text was too long for the text object. It was truncated.</a></li> +<li><a href="MSG_CARIMP_MISSING_PARTNO.html#MSG_CARIMP_MISSING_PARTNO">C.2.97 The following car has no Part Number...</a></li> +<li><a href="MSG_CARIMP_MISSING_DIMS.html#MSG_CARIMP_MISSING_DIMS">C.2.98 The following car has no dimensions and a...</a></li> +<li><a href="MSG_CARIMP_IGNORED_COLUMN.html#MSG_CARIMP_IGNORED_COLUMN">C.2.99 The following column in the Car Import file will be ignored:...</a></li> +<li><a href="MSG_CANT_MOVE_UNDER_TRAIN.html#MSG_CANT_MOVE_UNDER_TRAIN">C.2.100 The position of a turnout or turntable cannot be changed while occupied by a train.</a></li> +<li><a href="MSG_SPLITTED_OBJECT_TOO_SHORT.html#MSG_SPLITTED_OBJECT_TOO_SHORT">C.2.101 The resulting length of one track piece is shorter than the minimum length of %d.</a></li> +<li><a href="MSG_STRUCT_NO_STRUCTS.html#MSG_STRUCT_NO_STRUCTS">C.2.102 There are no structures to choose from in the structure...</a></li> +<li><a href="MSG_TURNOUT_NO_TURNOUT.html#MSG_TURNOUT_NO_TURNOUT">C.2.103 There are no turnouts to choose from in the turnout...</a></li> +<li><a href="MSG_NO_UNCONN_EP.html#MSG_NO_UNCONN_EP">C.2.104 There are no unconnected end points for this track</a></li> +<li><a href="MSG_PULL_FEW_SECTIONS.html#MSG_PULL_FEW_SECTIONS">C.2.105 There are too few sections in this loop.</a></li> +<li><a href="MSG_NO_REDO.html#MSG_NO_REDO">C.2.106 There is nothing to redo!</a></li> +<li><a href="MSG_NO_UNDO.html#MSG_NO_UNDO">C.2.107 There is nothing to undo!</a></li> +<li><a href="MSG_TOOMANYSEGSINGROUP.html#MSG_TOOMANYSEGSINGROUP">C.2.108 Too many track segments in Group.</a></li> +<li><a href="MSG_CANNOT_CHANGE.html#MSG_CANNOT_CHANGE">C.2.109 Track cannot be changed.</a></li> +<li><a href="MSG_POINT_INSIDE_TURNTABLE.html#MSG_POINT_INSIDE_TURNTABLE">C.2.110 Track endpoint is within turntable radius.</a></li> +<li><a href="MSG_MOVE_POINTS_AWAY_NO_INTERSECTION.html#MSG_MOVE_POINTS_AWAY_NO_INTERSECTION">C.2.111 Track intersection not possible; move points away from frog.</a></li> +<li><a href="MSG_TRK_TOO_SHORT.html#MSG_TRK_TOO_SHORT">C.2.112 Track is too short by N.NNN</a></li> +<li><a href="MSG_RADIUS_LSS_EASE_MIN.html#MSG_RADIUS_LSS_EASE_MIN">C.2.113 Track radius (N.NNN) is smaller than easement minimum (N.NNN).</a></li> +<li><a href="MSG_SEGMENT_NOT_ON_PATH.html#MSG_SEGMENT_NOT_ON_PATH">C.2.114 Track segment N not on Path for Turnout</a></li> +<li><a href="MSG_TOOMANYSEGSINGROUP2.html#MSG_TOOMANYSEGSINGROUP2">C.2.115 Track segments appear too late in Group segment list.</a></li> +<li><a href="MSG_CANT_MODIFY_FROZEN_TRK.html#MSG_CANT_MODIFY_FROZEN_TRK">C.2.116 Tracks in a frozen layer cannot be modified.</a></li> +<li><a href="MSG_CANT_MODIFY_MODULE_TRK.html#MSG_CANT_MODIFY_MODULE_TRK">C.2.117 Tracks in a module cannot be modified.</a></li> +<li><a href="MSG_SEGMENTS_DIFFER.html#MSG_SEGMENTS_DIFFER">C.2.118 Turnout definition contains non-track segments....</a></li> +<li><a href="MSG_TURNTABLE_DIAM_GTR_0.html#MSG_TURNTABLE_DIAM_GTR_0">C.2.119 Turntable diameter must greater than 0.</a></li> +<li><a href="MSG_UNDO_ASSERT.html#MSG_UNDO_ASSERT">C.2.120 Undo assertion failure %s:%d...</a></li> +<li><a href="MSG_LAYOUT_LINES_SKIPPED.html#MSG_LAYOUT_LINES_SKIPPED">C.2.121 While processing Layout file %s, %d lines were skipped because they were not recognized.</a></li> +<li><a href="MSG_PARAM_LINES_SKIPPED.html#MSG_PARAM_LINES_SKIPPED">C.2.122 While processing Parameter file %s, %d lines were skipped because they were not recognized.</a></li> +<li><a href="MSG_BETA_NOTICE.html#MSG_BETA_NOTICE">C.2.123 XTrackCAD Version %s: Please note that this Beta Version of XTrackCAD is still undergoing final testing before its official release. The sole purpose of this Beta Version is to conduct testing and obtain feedback. Should you encounter any bugs, glitches, lack of functionality or other problems, please let us know immediately so we can rectify these accordingly. Your help in this regard is greatly appreciated!</a></li> +<li><a href="MSG_BITMAP_SIZE_WARNING.html#MSG_BITMAP_SIZE_WARNING">C.2.124 You have specified a large bitmap....</a></li> +<li><a href="MSG_PT_IS_NOT_TRK.html#MSG_PT_IS_NOT_TRK">C.2.125 [X Y] is not a track</a></li> +</ul> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>A Helix must have one or more loops of track.</title> +<link rel="previous" href="messageList.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_SEL_TRK_FROZEN.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_HELIX_TURNS_GTR_0"></a>C.2.1 A Helix must have one or more loops of track.</h1> +<p> +A Helix cannot be created with less than one complete loop of track. Anything less than one loop is considered a section of curved track. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>A frozen layer contains selected track. Command cannot be executed.</title> +<link rel="previous" href="MSG_HELIX_TURNS_GTR_0.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_LARGE_FONT.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_SEL_TRK_FROZEN"></a>C.2.2 A frozen layer contains selected track. Command cannot be executed.</h1> +<p> +This operation cannot be executed as segments of Selected track are present on a frozen layer. Track changes or deletions may be performed only on unfrozen layers. Deselect objects that appear on frozen layers or unfreeze the layers. +</p> +<p> +Refer to <a href="cmdLayer.html#cmdLayer">section 2.9.5</a> for detail. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>A large font has been selected....</title> +<link rel="previous" href="MSG_SEL_TRK_FROZEN.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_TODSGN_DESC_NONBLANK.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_LARGE_FONT"></a>C.2.3 A large font has been selected....</h1> +<p> +A large font has been selected. Large fonts (or changing fonts sizes) may take a noticeable amount of time to load. +</p> +<p> +Refer to <a href="cmdText.html#cmdText">section 2.3.9</a> for detail. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>All description fields present in the Turnout...</title> +<link rel="previous" href="MSG_LARGE_FONT.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_GROUP_NONBLANK.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_TODSGN_DESC_NONBLANK"></a>C.2.4 All description fields present in the Turnout...</h1> +<p> +Turnout descriptions should be as accurate as possible. All description fields listed in the <strong>Turnout Designer</strong> must contain appropriate information. +</p> +<p> +Refer to <a href="cmdTurnoutNew.html#cmdTurnoutNew">section 2.9.9</a> for detail. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>All fields listed in the Group dialog must contain data....</title> +<link rel="previous" href="MSG_TODSGN_DESC_NONBLANK.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_TODSGN_VALUES_GTR_0.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_GROUP_NONBLANK"></a>C.2.5 All fields listed in the Group dialog must contain data....</h1> +<p> +The <strong>Group</strong> dialog shows the Manufacturer, Description and part number (Title) of the new definition. Initial values are based on selected turnouts and structures or on the last <strong>Ungroup</strong>ed object. The dialog also contains a toggle button (<strong>Replace with new group</strong>?), which is used if you want to replace the selected objects with the new definition. All fields listed in this dialog window must contain data. +</p> +<p> +Refer to <a href="cmdGroup.html#cmdGroup">section 2.9.4</a> for detail. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>All values specified in the Turnout Designer must be...</title> +<link rel="previous" href="MSG_GROUP_NONBLANK.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_CURVE_OUT_OF_RANGE.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_TODSGN_VALUES_GTR_0"></a>C.2.6 All values specified in the Turnout Designer must be...</h1> +<p> +Turnout dimensions should be as accurate as possible. All values specified in the <strong>Turnout Designer</strong> must be greater than 0. +</p> +<p> +Refer to <a href="cmdTurnoutNew.html#cmdTurnoutNew">section 2.9.9</a> for detail. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Angle must be between 0° and 360°.</title> +<link rel="previous" href="MSG_TODSGN_VALUES_GTR_0.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_CUSTMGM_DELETE_CONFIRM.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_CURVE_OUT_OF_RANGE"></a>C.2.7 Angle must be between 0° and 360°.</h1> +<p> +The angle specified for a curve must be between 0° and 360°. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Are you sure you want to delete the NNN definition(s)?</title> +<link rel="previous" href="MSG_CURVE_OUT_OF_RANGE.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_WBITMAP_FAILED.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_CUSTMGM_DELETE_CONFIRM"></a>C.2.8 Are you sure you want to delete the NNN definition(s)?</h1> +<p> +You are about to delete a custom turnout or structure design from the <strong>Custom Design</strong> file (<code>xtrkcad.cus</code>) file. This action cannot be undone. +</p> +<p> +Refer to <a href="installDir.html#installDir">section 1.9.2</a> and <a href="workDir.html#workDir">section 1.9.3</a> for an explanation of the files used by <em>XTrackCAD</em>. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Bitmap create or write function failed.</title> +<link rel="previous" href="MSG_CUSTMGM_DELETE_CONFIRM.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_BITMAP_TOO_LARGE.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_WBITMAP_FAILED"></a>C.2.9 Bitmap create or write function failed.</h1> +<p> +Your attempt to create or write a bitmap file failed. This could be due to the bitmap being too large or a lack of system resources. Try creating a smaller Bitmap or freeing system resources by closing other applications and dialog windows. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Bitmap is too large.</title> +<link rel="previous" href="MSG_WBITMAP_FAILED.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_POLY_MULTIPLE_SELECTED.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_BITMAP_TOO_LARGE"></a>C.2.10 Bitmap is too large.</h1> +<p> +A Bitmap must be less than 32000 pixels in height or width. Try increasing the DPI (or DPCM) value. +</p> +<p> +Refer to <a href="cmdOutputbitmap.html#cmdOutputbitmap">section 2.5.2</a> for detail. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Can't delete multiple points at once</title> +<link rel="previous" href="MSG_BITMAP_TOO_LARGE.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_GRID_ENABLE_SPACE_GTR_0.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_POLY_MULTIPLE_SELECTED"></a>C.2.11 Can't delete multiple points at once</h1> +<p> +Polygons and Poly Lines points can only be deleted one at a time. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Cannot Enable Grid; spacing must be greater than 0</title> +<link rel="previous" href="MSG_POLY_MULTIPLE_SELECTED.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_CANT_GROUP_BUMPER1.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_GRID_ENABLE_SPACE_GTR_0"></a>C.2.12 Cannot Enable Grid; spacing must be greater than 0</h1> +<p> +Before the horizontal or vertical <strong>Snap Grid</strong> can be <strong>Enable</strong>d, the corresponding <em>Spacing</em> value(s) on the <strong>Grid</strong> dialog must be set to a value greater than 0. +</p> +<p> +Refer to <a href="cmdGrid.html#cmdGrid">section 2.12.2</a> for detail. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Cannot Group Bumper Track. The track has been unselected.</title> +<link rel="previous" href="MSG_GRID_ENABLE_SPACE_GTR_0.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_CANNOT_GROUP_TRACK.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_CANT_GROUP_BUMPER1"></a>C.2.13 Cannot Group Bumper Track. The track has been unselected.</h1> +<p> +Bumper tracks (tracks with 1 endpoint) are not supported by the Group command. Convert the Bumper track to a Straight track by Ungrouping <a href="cmdUngroup.html#cmdUngroup">section 2.9.11</a> it first. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Cannot Group selected track type %s.</title> +<link rel="previous" href="MSG_CANT_GROUP_BUMPER1.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_JOIN_NOTBEZIERORCORNU.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_CANNOT_GROUP_TRACK"></a>C.2.14 Cannot Group selected track type %s.</h1> +<p> +Group objects are formed from Straight, Curved, Turnout or Sectional track or Structures or Draw elements. The selected objects include an object which is not one of these. Reselect the objects, including only elements of these types. +</p> +<p> +Refer to <a href="cmdGroup.html#cmdGroup">section 2.9.4</a> for detail. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Cannot Join Bezier or Cornu track if Easement is not Cornu</title> +<link rel="previous" href="MSG_CANNOT_GROUP_TRACK.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_JOIN_EASEMENTS.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_JOIN_NOTBEZIERORCORNU"></a>C.2.15 Cannot Join Bezier or Cornu track if Easement is not Cornu</h1> +<p> +You must change the Easement value to Cornu in order to join Bezier or Cornu Tracks +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Cannot Join; Easements do not align or abut.</title> +<link rel="previous" href="MSG_JOIN_NOTBEZIERORCORNU.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_JOIN_CORNU_SAME.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_JOIN_EASEMENTS"></a>C.2.16 Cannot Join; Easements do not align or abut.</h1> +<p> +You are trying to <strong>Join</strong> two <em>easement</em> curves. This can be achieved only if the two curves abut and are aligned. Otherwise, you can delete the <em>easement</em> curves and try to <strong>Join</strong> to connected tracks. +</p> +<p> +Refer to <a href="cmdJoin.html#cmdJoin">section 2.2.7</a> for detail. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Cannot Join; Selected endpoints are on same track.</title> +<link rel="previous" href="MSG_JOIN_EASEMENTS.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_JOIN_SAME.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_JOIN_CORNU_SAME"></a>C.2.17 Cannot Join; Selected endpoints are on same track.</h1> +<p> +You are trying to <strong>Join</strong> a section of track with itself. Different tracks must selected when using the <strong>Join</strong> command. +</p> +<p> +Refer to <a href="cmdJoin.html#cmdJoin">section 2.2.7</a> for detail. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Cannot Join; Selected endpoints are on same track.</title> +<link rel="previous" href="MSG_JOIN_CORNU_SAME.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_SELECTED_TRACKS_PARALLEL.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_JOIN_SAME"></a>C.2.18 Cannot Join; Selected endpoints are on same track.</h1> +<p> +You are trying to <strong>Join</strong> a section of track with itself. Different tracks must selected when using the <strong>Join</strong> command. +</p> +<p> +Refer to <a href="cmdJoin.html#cmdJoin">section 2.2.7</a> for detail. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Cannot Join; Selected tracks are parallel.</title> +<link rel="previous" href="MSG_JOIN_SAME.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_GRID_SHOW_SPACE_GTR_0.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_SELECTED_TRACKS_PARALLEL"></a>C.2.19 Cannot Join; Selected tracks are parallel.</h1> +<p> +These tracks cannot be joined as they are parallel to each other and the selected <em>endpoints</em>, point in opposite directions. To <strong>Join</strong> these two tracks, pick <em>endpoints</em> that point in the same direction. +</p> +<p> +Refer to <a href="cmdJoin.html#cmdJoin">section 2.2.7</a> for detail. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Cannot Show Grid; spacing must be greater than 0</title> +<link rel="previous" href="MSG_SELECTED_TRACKS_PARALLEL.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_CHANGE_ELEV_MODE.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_GRID_SHOW_SPACE_GTR_0"></a>C.2.20 Cannot Show Grid; spacing must be greater than 0</h1> +<p> +Before the <strong>Snap Grid</strong> can be <strong>Show</strong>n, corresponding horizontal or vertical <em>Spacing</em> value(s) on the <strong>Grid</strong> dialog must be set to a value greater than 0. +</p> +<p> +Refer to <a href="cmdGrid.html#cmdGrid">section 2.12.2</a> for detail. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Cannot change elevation mode.</title> +<link rel="previous" href="MSG_GRID_SHOW_SPACE_GTR_0.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_LAYER_FREEZE.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_CHANGE_ELEV_MODE"></a>C.2.21 Cannot change elevation mode.</h1> +<p> +In the <strong>Profile</strong> command, the <strong>Elevation</strong> mode for this <em>endpoint</em> can be change only if it is <strong>Defined</strong>, <strong>Ignored</strong> or <strong>None</strong>. The <strong>Elevation</strong> command can be used to change this <em>endpoint</em>. +</p> +<p> +Refer to <a href="cmdElevation.html#cmdElevation">section 2.2.5</a> for detail. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Cannot freeze current layer</title> +<link rel="previous" href="MSG_CHANGE_ELEV_MODE.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_LAYER_HIDE.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_LAYER_FREEZE"></a>C.2.22 Cannot freeze current layer</h1> +<p> +The current <strong>Layer</strong> is where most new objects are created. It's not possible to freeze this layer, since it would not be able to create objects. Change the current <strong>Layer</strong> to some other <strong>Layer</strong> before trying to freeze this Layer. +</p> +<p> +Refer to <a href="cmdLayer.html#cmdLayer">section 2.9.5</a> for detail. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Cannot hide current layer</title> +<link rel="previous" href="MSG_LAYER_FREEZE.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_JOIN_TURNTABLE.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_LAYER_HIDE"></a>C.2.23 Cannot hide current layer</h1> +<p> +The current <strong>Layer</strong> is where most new objects are created. It's not possible to hide this layer, since it would not be possible to see the objects. Change the current <strong>Layer</strong> to some other <strong>Layer</strong> before trying to hide this Layer. +</p> +<p> +Refer to <a href="cmdLayer.html#cmdLayer">section 2.9.5</a> for detail. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Cannot join from a turntable, try to a turntable</title> +<link rel="previous" href="MSG_LAYER_HIDE.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_PRMFIL_OPEN_NEW.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_JOIN_TURNTABLE"></a>C.2.24 Cannot join from a turntable, try to a turntable</h1> +<p> +You cannot select a <strong>Turntable</strong> as the second track in <strong>Join</strong> command. If you wish to <strong>Join</strong> to a <strong>Turntable</strong> then select the <strong>Turntable</strong> as the first track in the <strong>Join</strong> command. +</p> +<p> +Refer to <a href="cmdJoin.html#cmdJoin">section 2.2.7</a> for detail. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Cannot open New Parameter File: FILENAME</title> +<link rel="previous" href="MSG_JOIN_TURNTABLE.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_LAYER_SEL_FROZEN.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_PRMFIL_OPEN_NEW"></a>C.2.25 Cannot open New Parameter File: FILENAME</h1> +<p> +During the processing of <strong>Parameter Files</strong> after updating to a new version of <em>XTrackCAD</em>, one of updated <strong>Parameter Files</strong> could not be found. Check that the installation had no errors. You can use the <strong>Parameter Files</strong> dialog to locate the parameter file. +</p> +<p> +Refer to <a href="cmdPrmfile.html#cmdPrmfile">section 2.5.7</a> for detail. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Cannot select a frozen layer</title> +<link rel="previous" href="MSG_PRMFIL_OPEN_NEW.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_CANT_SPLIT_TRK.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_LAYER_SEL_FROZEN"></a>C.2.26 Cannot select a frozen layer</h1> +<p> +The current <strong>Layer</strong> is where most new objects are created. It's not possible to select a frozen <strong>Layer</strong>, since it would not be possible to create objects. Unfreeze this <strong>Layer</strong> before trying to make this the current <strong>Layer</strong>. +</p> +<p> +Refer to <a href="cmdLayer.html#cmdLayer">section 2.9.5</a> for detail. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Cannot split TYPE track</title> +<link rel="previous" href="MSG_LAYER_SEL_FROZEN.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_LAYER_MODULE.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_CANT_SPLIT_TRK"></a>C.2.27 Cannot split TYPE track</h1> +<p> +This fixed track like turnouts or or other sectional track cannot be <strong>Split</strong>. Only flexible, Cornu, straight and curved tracks can be <strong>Split</strong>. To <strong>Split</strong> a Turnout, hold down the Shift key then <em>Left-Click</em> on the position where the track should be <strong>Split</strong>. +</p> +<p> +Refer to <a href="cmdSplitTrack.html#cmdSplitTrack">section 2.2.17.1</a> for detail. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Cannot turn current layer into a Module</title> +<link rel="previous" href="MSG_CANT_SPLIT_TRK.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_CUSTMGM_CANT_WRITE.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_LAYER_MODULE"></a>C.2.28 Cannot turn current layer into a Module</h1> +<p> +The current <strong>Layer</strong> is where new objects are created. It's not possible to turn this layer into a module, since then the objects can't be chnaged or added. Change the current <strong>Layer</strong> to some other <strong>Layer</strong> before trying to make this Layer into a module. +</p> +<p> +Refer to <a href="cmdLayer.html#cmdLayer">section 2.9.5</a> for detail. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Cannot write to parameter file: FILENAME</title> +<link rel="previous" href="MSG_LAYER_MODULE.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_CARIMP_DUP_INDEX.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_CUSTMGM_CANT_WRITE"></a>C.2.29 Cannot write to parameter file: FILENAME</h1> +<p> +The specified parameter file can not be written to. Make sure the file and or directory is not marked as read only. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Car Index number duplicated.</title> +<link rel="previous" href="MSG_CUSTMGM_CANT_WRITE.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_CONN_PARAMS_TOO_BIG.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_CARIMP_DUP_INDEX"></a>C.2.30 Car Index number duplicated.</h1> +<p> +Each Car in your inventory must have a unique index value. If a duplicate index number is found during the <strong>Import</strong> process it will be replaced with a new, unused value. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Connection parameters reset to maximum values.</title> +<link rel="previous" href="MSG_CARIMP_DUP_INDEX.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_CONN_PARAMS_TOO_SMALL.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_CONN_PARAMS_TOO_BIG"></a>C.2.31 Connection parameters reset to maximum values.</h1> +<p> +The parameters <em>Minimum Track Length</em>, <em>Connection Angle</em> and <em>Connection Distance</em> have maximum values that cannot be set to bigger values. The maximum values are 1.0"/2.54cm, 10° and 1.0"/2.54cm respectively. +</p> +<p> +Refer to <a href="cmdPref.html#cmdPref">section 2.10.7</a> for detail. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Connection parameters reset to minimum values.</title> +<link rel="previous" href="MSG_CONN_PARAMS_TOO_BIG.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_CANT_PASTE.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_CONN_PARAMS_TOO_SMALL"></a>C.2.32 Connection parameters reset to minimum values.</h1> +<p> +The parameters <em>Minimum Track Length</em>, <em>Connection Angle</em> and <em>Connection Distance</em> have minimum values that cannot be set to smaller values. The minimum values are 0.1"/0.254cm, 1° and 0.1"/0.254cm respectively. +</p> +<p> +Refer to <a href="cmdPref.html#cmdPref">section 2.10.7</a> for detail. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Copy/Paste buffer is empty. There is nothing to Paste.</title> +<link rel="previous" href="MSG_CONN_PARAMS_TOO_SMALL.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_PROG_CORRUPTED.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_CANT_PASTE"></a>C.2.33 Copy/Paste buffer is empty. There is nothing to Paste.</h1> +<p> +An attempt was made to <strong>Paste</strong> an object onto the layout however the Copy/Paste buffer was empty. This error generally occurs when the <strong>Paste</strong> command is executed without first executing the <strong>Copy</strong> command. +</p> +<p> +Refer to <a href="editM.html#editM">section 2.4</a> for detail. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Critical file damaged!...</title> +<link rel="previous" href="MSG_CANT_PASTE.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_TODSGN_CROSSOVER_TOO_SHORT.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_PROG_CORRUPTED"></a>C.2.34 Critical file damaged!...</h1> +<p> +A critical file is corrupt. Unfortunately it will be necessary to reinstall the software or contact the XTrackCAD project development team at SourceForge in order to overcome this error. +</p> +<p> +Please report this error to the <em>XTrackCAD</em> project development team at SourceForge. The process for reporting errors is outlined in <a href="bugs.html#bugs">section 1.11.1</a>. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Crossover length is too short. Correct...</title> +<link rel="previous" href="MSG_PROG_CORRUPTED.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_CURVE_TOO_LARGE.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_TODSGN_CROSSOVER_TOO_SHORT"></a>C.2.35 Crossover length is too short. Correct...</h1> +<p> +The length of crossover segments must be greater than the track gauge. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Curved track is too large.</title> +<link rel="previous" href="MSG_TODSGN_CROSSOVER_TOO_SHORT.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_TODSGN_REPLACE.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_CURVE_TOO_LARGE"></a>C.2.36 Curved track is too large.</h1> +<p> +The length of the curved track is limited to sum of the room dimensions. This limitation prevents creation of curves that are unreasonably large. Adjust the mouse position to create a smaller Curve. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Definition name is already in use. Saving this...</title> +<link rel="previous" href="MSG_CURVE_TOO_LARGE.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_SAVE_CHANGES.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_TODSGN_REPLACE"></a>C.2.37 Definition name is already in use. Saving this...</h1> +<p> +The definition you're attempting to create uses the same name as an existing definition. Saving the definition with the same name will cause <em>XTrackCAD</em> to replace the existing definition, making the existing definition inaccessible. If the previous definition must be preserved, then choose a different name for the new definition. If necessary, the <strong>Custom Management</strong> dialog can be used to change definition names. +</p> +<p> +Refer to <a href="cmdCustmgm.html#cmdCustmgm">section 2.9.2</a> for detail. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Do you want to save the changes made to your Layout?</title> +<link rel="previous" href="MSG_TODSGN_REPLACE.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_CARIMP_DUP_COLUMNS.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_SAVE_CHANGES"></a>C.2.38 Do you want to save the changes made to your Layout?</h1> +<p> +The <strong>Exit</strong> command was selected without first saving changes that have been made to the layout. This notice gives you the chance to save your changes before the program ends. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Duplicate column headers found in Car Import file.</title> +<link rel="previous" href="MSG_SAVE_CHANGES.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_EP_ON_PATH.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_CARIMP_DUP_COLUMNS"></a>C.2.39 Duplicate column headers found in Car Import file.</h1> +<p> +The <strong>Car Import</strong> function reads car values from a Comma-Separated-Value (CSV) file. The import file must contain headers for at least the <em>Scale</em>, <em>Prototype</em>, <em>Manufacturer</em> and <em>Partno</em> columns. In addition, the following column headers may also be included: <em>Index</em>, <em>Type</em>, <em>Description</em>, <em>Roadname</em>, <em>Repmark</em>, <em>Number</em>, <em>Options</em>, <em>CarLength</em>, <em>CarWidth</em>, <em>CoupledLength</em>, <em>TruckCenter</em>, <em>Color</em>, <em>PurchPrice</em>, <em>CurrPrice</em>, <em>Condition</em>, <em>PurchDate</em>, <em>ServiceDate</em> and <em>Notes</em>. +</p> +<p> +It appears the CSV file that you're attempting to <strong>Import</strong> contains more than one row of column headers. Review the CSV files content and ensure only one row of header data exists. +</p> +<p> +Refer to <a href="cmdCarinv.html#cmdCarinv">section 2.9.1</a> for detail. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Endpoint already on Path.</title> +<link rel="previous" href="MSG_CARIMP_DUP_COLUMNS.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_UPGRADE_VERSION1.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_EP_ON_PATH"></a>C.2.40 Endpoint already on Path.</h1> +<p> +An <em>endpoint</em> that is already on the <strong>Profile Path</strong> has been selected. Select a different <em>endpoint</em>; one that is on a track that is not drawn in Purple. +</p> +<p> +Refer to <a href="cmdProfile.html#cmdProfile">section 2.2.12</a> for detail. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>File version %ld is greater than supported...</title> +<link rel="previous" href="MSG_EP_ON_PATH.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_UPGRADE_VERSION2.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_UPGRADE_VERSION1"></a>C.2.41 File version %ld is greater than supported...</h1> +<p> +The layout file that you're attempting to load was created using a newer version of <em>XTrackCAD</em>. In order to load this file it will be necessary to upgrade your version of <em>XTrackCAD</em> to at least the version identified within the error message. +</p> +<p> +Take full advantage of the latest features within <em>XTrackCAD</em> by visiting the <a href="http://www.xtrkcad.org/" target="_blank"><em>XTrackCAD</em> Website</a> and downloading the latest release. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>File version %ld is greater than supported...</title> +<link rel="previous" href="MSG_UPGRADE_VERSION1.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_PARAM_UPGRADE_VERSION1.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_UPGRADE_VERSION2"></a>C.2.42 File version %ld is greater than supported...</h1> +<p> +The layout file that you're attempting to load was created using a newer version of <em>XTrackCAD</em>. In order to load this file it will be necessary to upgrade your version of <em>XTrackCAD</em> to at least the version identified within the error message. +</p> +<p> +Take full advantage of the latest features within <em>XTrackCAD</em> by visiting the <a href="http://www.xtrkcad.org/" target="_blank"><em>XTrackCAD</em> Fork Website</a> and downloading the latest release. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>File version %ld is greater than supported...</title> +<link rel="previous" href="MSG_UPGRADE_VERSION2.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_PARAM_UPGRADE_VERSION2.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_PARAM_UPGRADE_VERSION1"></a>C.2.43 File version %ld is greater than supported...</h1> +<p> +The parameter file that you're attempting to load was designed for a newer version of <em>XTrackCAD</em>. In order to load this file it will be necessary to upgrade your version of <em>XTrackCAD</em> to at least the version identified within the error message. +</p> +<p> +Take full advantage of the latest features within <em>XTrackCAD</em> by visiting the <a href="http://www.xtrkcad.org/" target="_blank"><em>XTrackCAD</em> Website</a> and downloading the latest release. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>File version %ld is greater than supported...</title> +<link rel="previous" href="MSG_PARAM_UPGRADE_VERSION1.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_TRK_ALREADY_CONN.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_PARAM_UPGRADE_VERSION2"></a>C.2.44 File version %ld is greater than supported...</h1> +<p> +The parameter file that you're attempting to load was designed for a newer version of <em>XTrackCAD</em>. In order to load this file it will be necessary to upgrade your version of <em>XTrackCAD</em> to at least the version identified within the error message. +</p> +<p> +Take full advantage of the latest features within <em>XTrackCAD</em> by visiting the <a href="http://www.xtrkcad.org/" target="_blank"><em>XTrackCAD</em> Fork Website</a> and downloading the latest release. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>First|Second track is already connected.</title> +<link rel="previous" href="MSG_PARAM_UPGRADE_VERSION2.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_MOVE_POINTS_OTHER_SIDE.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_TRK_ALREADY_CONN"></a>C.2.45 First|Second track is already connected.</h1> +<p> +To <strong>Join</strong> one track with another, the <em>endpoints</em> selected for connection cannot be connected with any other track. Pick another track with an unconnected <em>endpoint</em> or disconnect one of the <em>endpoints</em> using the <strong>Split</strong> command. +</p> +<p> +Refer to <a href="cmdJoin.html#cmdJoin">section 2.2.7</a> for detail regarding the <strong>Join</strong> command or <a href="cmdSplitTrack.html#cmdSplitTrack">section 2.2.17.1</a> for detail regarding the <strong>Split</strong> command. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Frog angle prevents placement of points. Move points to opposite side of frog.</title> +<link rel="previous" href="MSG_TRK_ALREADY_CONN.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_CANT_PLACE_FROGPOINTS.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_MOVE_POINTS_OTHER_SIDE"></a>C.2.46 Frog angle prevents placement of points. Move points to opposite side of frog.</h1> +<p> +The frog angle prevents points from being placed on this side of the frog. Place points on opposite side of frog or retry this command and create the frog in the opposite direction. +</p> +<p> +Refer to <a href="cmdHandLaidTurnout.html#cmdHandLaidTurnout">section 2.1.3</a> for detail. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Frog|Points cannot be placed on a turnout, circle or helix.</title> +<link rel="previous" href="MSG_MOVE_POINTS_OTHER_SIDE.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_NO_ROOM_BTW_TRKS.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_CANT_PLACE_FROGPOINTS"></a>C.2.47 Frog|Points cannot be placed on a turnout, circle or helix.</h1> +<p> +The frog or points of a hand-laid turnout cannot be placed on a turnout, circle or helix track. Choose a straight or curved section of track or use the <strong>Split</strong> command to create a curve from the circle track. +</p> +<p> +Refer to <a href="cmdHandLaidTurnout.html#cmdHandLaidTurnout">section 2.1.3</a> for detail regarding hand laid turnouts or <a href="cmdSplitTrack.html#cmdSplitTrack">section 2.2.17.1</a> for detail regarding the <strong>Split</strong> command. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Insufficient space between existing stall tracks.</title> +<link rel="previous" href="MSG_CANT_PLACE_FROGPOINTS.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_JOIN_DIFFER_ELEV.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_NO_ROOM_BTW_TRKS"></a>C.2.48 Insufficient space between existing stall tracks.</h1> +<p> +There is insufficient space between the two existing turntable stall tracks to place a new stall track. Either place the new stall track on a different part of the turntable or decrease the <em>Turntable Angle</em> using the <strong>Command Options</strong> dialog. +</p> +<p> +Refer to <a href="cmdTurntable.html#cmdTurntable">section 2.1.9</a> for detail regarding turntables or <a href="cmdCmdopt.html#cmdCmdopt">section 2.10.2</a> for detail regarding the <strong>Command Options</strong> dialog and <em>Turntable Angle</em>s. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Joining tracks with differing elevations (N.NNN)</title> +<link rel="previous" href="MSG_NO_ROOM_BTW_TRKS.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_TRK_DESC_NOT_VISIBLE.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_JOIN_DIFFER_ELEV"></a>C.2.49 Joining tracks with differing elevations (N.NNN)</h1> +<p> +You are connecting two <em>endpoints</em> which differ in heights by N.NNN. The elevation of the connection will be the average of the two heights. You should check if this is a problem. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Label description is hidden</title> +<link rel="previous" href="MSG_JOIN_DIFFER_ELEV.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_DESC_NOT_VISIBLE.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_TRK_DESC_NOT_VISIBLE"></a>C.2.50 Label description is hidden</h1> +<p> +The <strong>Move Description</strong> command can only be used when labels are visible on the layout. Labels can be hidden using the Context Menu. +</p> +<p> +Use the Context Menu to toggle a track's visbility on and off. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Label descriptions not visible</title> +<link rel="previous" href="MSG_TRK_DESC_NOT_VISIBLE.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_OBJECT_TOO_SHORT.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_DESC_NOT_VISIBLE"></a>C.2.51 Label descriptions not visible</h1> +<p> +The <strong>Move Description</strong> command can only be used when labels are visible on the layout. Labels will not be visible when the <strong>Label Scale</strong> is set to a smaller value than the current drawing scale or when no items are enabled in the <strong>Label Enable</strong> section of the <strong>Display Options</strong> dialog. +</p> +<p> +Check the <strong>Display Options</strong> dialog (<strong>Options>Display</strong>) to determine if; +</p> +<p> + +</p> +<ul><li> +the <strong>Label Scale</strong> is set to a value smaller than or equal to the current drawing scale. +</li> +<li> +at least one attribute within the <strong>Label Enable</strong> section is selected. You will of course want to ensure the type of label you wish to move is selected. +</li> +</ul> +<p> + +</p> +<p> +Refer to <a href="cmdMoveLabel.html#cmdMoveLabel">section 2.2.10</a> for detail regarding <strong>Description</strong> movement or <a href="cmdDisplay.html#cmdDisplay">section 2.10.3</a> for detail regarding <strong>Display</strong> attributes. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Length of object is too short.</title> +<link rel="previous" href="MSG_DESC_NOT_VISIBLE.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_PRINT_MAX_SIZE.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_OBJECT_TOO_SHORT"></a>C.2.52 Length of object is too short.</h1> +<p> +The specified length for the object being modified is too short. Increase the objects length. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Maximum allowed page size is W x H</title> +<link rel="previous" href="MSG_OBJECT_TOO_SHORT.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_PRMFIL_NO_CONTENTS.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_PRINT_MAX_SIZE"></a>C.2.53 Maximum allowed page size is W x H</h1> +<p> +Values for <strong>Page Width</strong> and <strong>Height</strong> can be manually entered thus overriding maximum values. For example, smaller values could be specified if each printed page is to contain an integral number of feet. Values larger than the selected paper size multiplied by the <em>Scale</em> cannot be entered. +</p> +<p> +Refer to <a href="cmdPrint.html#cmdPrint">section 2.5.9</a> for detail. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>New Parameter File has no CONTENTS line: FILENAME.</title> +<link rel="previous" href="MSG_PRINT_MAX_SIZE.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_NO_CARPROTO.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_PRMFIL_NO_CONTENTS"></a>C.2.54 New Parameter File has no CONTENTS line: FILENAME.</h1> +<p> +Each <strong>Parameter Files</strong> contains a line which identifies the contents. The specified file is missing this line. +</p> +<p> +Please report this error to the <em>XTrackCAD</em> project development team at SourceForge. The process for reporting errors is outlined in <a href="bugs.html#bugs">section 1.11.1</a>. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>No Car Prototypes are defined....</title> +<link rel="previous" href="MSG_PRMFIL_NO_CONTENTS.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_NO_CARS.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_NO_CARPROTO"></a>C.2.55 No Car Prototypes are defined....</h1> +<p> +No <strong>Car Prototypes</strong> are defined. Load a car prototype definition file (such as protoam.xtp) using the <strong>Parameter Files</strong> dialog or create a prototype definition using the <strong>Car Prototype</strong> dialog. +</p> +<p> +Refer to <a href="cmdPrmfile.html#cmdPrmfile">section 2.5.7</a> for detail regarding the <strong>Parameter Files</strong> or <a href="carprototype.html#carprototype">section 2.9.1.3</a> for detail regarding the <strong>Car Prototype</strong> dialog. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>No Cars are defined for the current scale....</title> +<link rel="previous" href="MSG_NO_CARPROTO.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_PRMFIL_NO_MAP.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_NO_CARS"></a>C.2.56 No Cars are defined for the current scale....</h1> +<p> +No Cars are defined for the current layout scale. Either set the scale to the value of already defined cars, or use the dialog to select cars of the current scale and add them to the <strong>Car Inventory</strong>. +</p> +<p> +Refer to <a href="cmdCarinv.html#cmdCarinv">section 2.9.1</a> for detail. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>No Parameter File Map for CONTENTS</title> +<link rel="previous" href="MSG_NO_CARS.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_GROUP_NO_PATHS.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_PRMFIL_NO_MAP"></a>C.2.57 No Parameter File Map for CONTENTS</h1> +<p> +The parameter file for <strong>CONTENTS</strong> has been moved or deleted. Use the <strong>Parameter Files</strong> dialog to locate the <strong>Parameter Files</strong>. +</p> +<p> +Refer to <a href="cmdPrmfile.html#cmdPrmfile">section 2.5.7</a> for detail. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>No Paths were detected when grouping selected Tracks.</title> +<link rel="previous" href="MSG_PRMFIL_NO_MAP.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_POLY_NOTHING_SELECTED.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_GROUP_NO_PATHS"></a>C.2.58 No Paths were detected when grouping selected Tracks.</h1> +<p> +Please contact development +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>No Point on a Poly shape selected.</title> +<link rel="previous" href="MSG_GROUP_NO_PATHS.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_NO_TURNOUTS_AVAILABLE.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_POLY_NOTHING_SELECTED"></a>C.2.59 No Point on a Poly shape selected.</h1> +<p> +Select a Poly shape and a single point in order to be able to delete it. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>No Turnouts|Structures are available.</title> +<link rel="previous" href="MSG_POLY_NOTHING_SELECTED.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_CARIMP_NO_DATA.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_NO_TURNOUTS_AVAILABLE"></a>C.2.60 No Turnouts|Structures are available.</h1> +<p> +The <strong>Update Turnouts and Structures</strong> command updates (or refreshes) selected turnouts, sectional tracks and structures on your layout with the current definitions from the loaded parameter files (<a href="cmdPrmfile.html#cmdPrmfile">Section 2.5.7</a>). Each selected object that is found in a parameter file is updated with the current definition. +</p> +<p> +If an object can not be found or if the new definition does not fit (same number of endpoints and all the endpoints have the same position and angle) then a dialog is displayed which contains suitable definitions that you can choose from. In the case of turnouts, this list is populated with turnouts having the same number of endpoints as the selected turnout. If turnouts with the same number of endpoints exist then this message is displayed. +</p> +<p> +Refer to <a href="cmdRefreshSpecial.html#cmdRefreshSpecial">section 2.9.10</a> for detail. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>No data present in Car Import file.</title> +<link rel="previous" href="MSG_NO_TURNOUTS_AVAILABLE.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_NO_EMPTY_LAYER.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_CARIMP_NO_DATA"></a>C.2.61 No data present in Car Import file.</h1> +<p> +The <strong>Car Import</strong> function reads car values from a Comma-Separated-Value (CSV) file. The import file must contain headers for at least the <em>Scale</em>, <em>Prototype</em>, <em>Manufacturer</em> and <em>Partno</em> columns. In addition, information relative to at least one car must be included in the file otherwise this error occurs. +</p> +<p> +Refer to <a href="cmdCarinv.html#cmdCarinv">section 2.9.1</a> for detail. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>No layer was found that has no contents, so the module can not be imported</title> +<link rel="previous" href="MSG_CARIMP_NO_DATA.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_NO_UNFROZEN_LAYER.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_NO_EMPTY_LAYER"></a>C.2.62 No layer was found that has no contents, so the module can not be imported</h1> +<p> +The import module function needs an empty layer to work with, but none could be found. Clear a layer and retry. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>No layer was found that wasn't frozen. Layer 0 is unfrozen.</title> +<link rel="previous" href="MSG_NO_EMPTY_LAYER.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_PRINT_NO_PAGES.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_NO_UNFROZEN_LAYER"></a>C.2.63 No layer was found that wasn't frozen. Layer 0 is unfrozen.</h1> +<p> +There has to be one layer that isn't frozen, Layer 0 will be unfrozen +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>No pages selected for printing.</title> +<link rel="previous" href="MSG_NO_UNFROZEN_LAYER.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_NO_PATH_TO_EP.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_PRINT_NO_PAGES"></a>C.2.64 No pages selected for printing.</h1> +<p> +Pages are selected for printing by clicking on the print grid on the layout. Use the <strong>Zoom Out</strong> command to bring more of the layout into view (<a href="cmdZoom.html#cmdZoom">Section 2.12.4</a>). The print grid can be moved using the <em>Shift+Left+Drag</em> command or rotated using the <em>Shift+Right+Drag</em> command. +</p> +<p> +Refer to <a href="cmdPrint.html#cmdPrint">section 2.5.9</a> for detail. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>No path between Profile and selected endpoint.</title> +<link rel="previous" href="MSG_PRINT_NO_PAGES.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_NO_SELECTED_TRK.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_NO_PATH_TO_EP"></a>C.2.65 No path between Profile and selected endpoint.</h1> +<p> +There is no path of track between the end of the <strong>Profile</strong> and the <em>endpoint</em> you have clicked on. +</p> +<p> +Refer to the <a href="cmdProfile.html#cmdProfile">section 2.2.12</a> for detail. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>No track(s) selected!</title> +<link rel="previous" href="MSG_NO_PATH_TO_EP.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_CARDESC_VALUE_ZERO.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_NO_SELECTED_TRK"></a>C.2.66 No track(s) selected!</h1> +<p> +The current command operates on <strong>Select</strong>ed tracks of which there are none. <strong>Select</strong> the desired track and try the command again. +</p> +<p> +Refer to <a href="cmdSelect.html#cmdSelect">section 2.2.16</a> for detail. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Numeric values on the Car Description...</title> +<link rel="previous" href="MSG_NO_SELECTED_TRK.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_MOVE_OUT_OF_BOUNDS.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_CARDESC_VALUE_ZERO"></a>C.2.67 Numeric values on the Car Description...</h1> +<p> +Numeric values on the <strong>Car Description</strong> dialog (Car Length, Car Width, Truck Centers, Coupled Length and Coupler Length) must be greater than zero. +</p> +<p> +Refer to <a href="cmdTrain.html#cmdTrain">section 2.9.8</a> for detail. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Object has moved beyond room boundaries.</title> +<link rel="previous" href="MSG_CARDESC_VALUE_ZERO.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_PARALLEL_SEP_GTR_0.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_MOVE_OUT_OF_BOUNDS"></a>C.2.68 Object has moved beyond room boundaries.</h1> +<p> +The last operation moved the object outside of room boundaries; room width and height. The <strong>Undo</strong> command can be used to move the object back. +</p> +<p> +Refer to <a href="cmdLayout.html#cmdLayout">section 2.10.6</a> for detail regarding room boundaries and <a href="cmdUndo.html#cmdUndo">section 2.4.9</a> for detail regarding the <strong>Undo</strong> command. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Parallel separation must be greater than 0, or the new guage must be different than the old.</title> +<link rel="previous" href="MSG_MOVE_OUT_OF_BOUNDS.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_CARPART_DUPNAME.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_PARALLEL_SEP_GTR_0"></a>C.2.69 Parallel separation must be greater than 0, or the new guage must be different than the old.</h1> +<p> +A parallel track with an identical gauge and separation of 0 or less cannot be created. Specify a positive value in the <strong>Separation</strong> field that appears in the Status Bar, or select a track with a different guage. +</p> +<p> +Refer to <a href="cmdParallel.html#cmdParallel">section 2.1.5</a> for detail. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Part Number for this Manufacturer already exists....</title> +<link rel="previous" href="MSG_PARALLEL_SEP_GTR_0.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_PLAYBACK_VERSION_UPGRADE.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_CARPART_DUPNAME"></a>C.2.70 Part Number for this Manufacturer already exists....</h1> +<p> +The <em>Part</em> definition you're attempting to create uses the same Manufacturer and Part Number as an existing definition. Saving the definition with the same Manufacturer and Part Number will cause <em>XTrakCAD</em> to update the existing definition. If the previous definition must be preserved, then choose a different Part Number for the new definition. +</p> +<p> +Refer to <a href="carpart.html#carpart">section 2.9.1.2</a> for detail. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Playback file version %ld is...</title> +<link rel="previous" href="MSG_CARPART_DUPNAME.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_PLAYBACK_LISTENTRY.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_PLAYBACK_VERSION_UPGRADE"></a>C.2.71 Playback file version %ld is...</h1> +<p> +The layout file that you're attempting to load was created using a newer version of <em>XTrackCAD</em>. In order to load this file it will be necessary to upgrade your version of <em>XTrackCAD</em> to at least the version identified within the error message. +</p> +<p> +Take full advantage of the latest features within <em>XTrackCAD</em> by visiting the <a href="http://www.xtrkcad.org/" target="_blank"><em>XTrackCAD</em> Fork Website</a> and downloading the latest release. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Playback: Cannot find list entry: NAME</title> +<link rel="previous" href="MSG_PLAYBACK_VERSION_UPGRADE.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_DOMOUSE_BAD_OP.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_PLAYBACK_LISTENTRY"></a>C.2.72 Playback: Cannot find list entry: NAME</h1> +<p> +This error is most likely caused by trying to <strong>Playback</strong> an incompatible <em>XTrackCAD</em> recording or demo file. +</p> +<p> +Refer to <a href="macroM.html#macroM">section 2.8</a> for detail. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Playback: unknown action NNN</title> +<link rel="previous" href="MSG_PLAYBACK_LISTENTRY.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_NO_PRINTER_SELECTED.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_DOMOUSE_BAD_OP"></a>C.2.73 Playback: unknown action NNN</h1> +<p> +This error is most likely caused by trying to <strong>Playback</strong> an incompatible <em>XTrackCAD</em> recording or demo file. +</p> +<p> +Refer to <a href="macroM.html#macroM">section 2.8</a> for detail. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Please select a printer from the Print Setup dialog.</title> +<link rel="previous" href="MSG_DOMOUSE_BAD_OP.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_MOVE_POINTS_AWAY_CLOSE.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_NO_PRINTER_SELECTED"></a>C.2.74 Please select a printer from the Print Setup dialog.</h1> +<p> +Printer Margins are specific to the selected printer, but no selected printer is chosen. You can select a printer from the Print Setup dialog. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Points are to close to frog; move away.</title> +<link rel="previous" href="MSG_NO_PRINTER_SELECTED.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_POLY_SHAPES_3_SIDES.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_MOVE_POINTS_AWAY_CLOSE"></a>C.2.75 Points are to close to frog; move away.</h1> +<p> +The points are being placed too close to the frog. Move the points away from the frog and try again. +</p> +<p> +Refer to <a href="cmdHandLaidTurnout.html#cmdHandLaidTurnout">section 2.1.3</a> for detail. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Polygons must have at least 3 nodes.</title> +<link rel="previous" href="MSG_MOVE_POINTS_AWAY_CLOSE.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_CARPROTO_DUPNAME.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_POLY_SHAPES_3_SIDES"></a>C.2.76 Polygons must have at least 3 nodes.</h1> +<p> +Polygons and Poly Lines must have at least 3 nodes. You're attempting to create a Polygon with only 2 sides or a PolyLine with one line segment. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Prototype name already exists....</title> +<link rel="previous" href="MSG_POLY_SHAPES_3_SIDES.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_RADIUS_GTR_0.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_CARPROTO_DUPNAME"></a>C.2.77 Prototype name already exists....</h1> +<p> +The <em>Prototype</em> definition you're attempting to create uses the same name as an existing definition. Saving the definition with the same name will cause <em>XTrackCAD</em> to update the existing definition. If the previous definition must be preserved, then choose a different Part Number for the new definition. +</p> +<p> +Refer to <a href="carprototype.html#carprototype">section 2.9.1.3</a> for detail. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Radius must be greater than 0.</title> +<link rel="previous" href="MSG_CARPROTO_DUPNAME.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_RADIUS_GTR_10000.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_RADIUS_GTR_0"></a>C.2.78 Radius must be greater than 0.</h1> +<p> +It's not possible to create a Circle or Helix with a radius of 0° or less. Specify a positive value in the <strong>Radius</strong> field that appears in the Status Bar. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Radius must be less than 10000.</title> +<link rel="previous" href="MSG_RADIUS_GTR_0.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_CARIMP_MISSING_COLUMNS.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_RADIUS_GTR_10000"></a>C.2.79 Radius must be less than 10000.</h1> +<p> +It's not possible to create a Circle or Helix with a radius of 10000° or more. Specify a smaller value in the <strong>Radius</strong> field. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Required column headers missing from Car Import file.</title> +<link rel="previous" href="MSG_RADIUS_GTR_10000.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_RESCALE_TOO_BIG.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_CARIMP_MISSING_COLUMNS"></a>C.2.80 Required column headers missing from Car Import file.</h1> +<p> +The <strong>Car Import</strong> function reads car values from a Comma-Separated-Value (CSV) file. The import file must contain headers for at least the <em>Scale</em>, <em>Prototype</em>, <em>Manufacturer</em> and <em>Partno</em> columns. In addition, the following column headers may also be included: <em>Index</em>, <em>Type</em>, <em>Description</em>, <em>Roadname</em>, <em>Repmark</em>, <em>Number</em>, <em>Options</em>, <em>CarLength</em>, <em>CarWidth</em>, <em>CoupledLength</em>, <em>TruckCenter</em>, <em>Color</em>, <em>PurchPrice</em>, <em>CurrPrice</em>, <em>Condition</em>, <em>PurchDate</em>, <em>ServiceDate</em> and <em>Notes</em>. +</p> +<p> +Refer to <a href="cmdCarinv.html#cmdCarinv">section 2.9.1</a> for detail. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Rescaled tracks do not fit within layouts room parameters...</title> +<link rel="previous" href="MSG_CARIMP_MISSING_COLUMNS.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_BAD_SCALE_NAME.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_RESCALE_TOO_BIG"></a>C.2.81 Rescaled tracks do not fit within layouts room parameters...</h1> +<p> +While using the <strong>Change Scale</strong> command to enlarge the layout, <em>XTrackCAD</em> determined that rescaled tracks do not fit within the layout rooms parameters. Using the <strong>Layout</strong> dialog, the rooms parameters (Height and width) should be set so as to accommodate the rescaled track. +</p> +<p> +Refer to <a href="cmdLayout.html#cmdLayout">section 2.10.6</a> for detail regarding <strong>Layout</strong> options or <a href="cmdRescale.html#cmdRescale">section 2.2.1</a> for detail regarding the <strong>Change Scale</strong> command. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Scale "SCALE1" is not valid. We will substitute a dummy scale based on "SCALE2". See 'Help|Recent Messages' for details.</title> +<link rel="previous" href="MSG_RESCALE_TOO_BIG.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_BAD_SCALE_INDEX.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_BAD_SCALE_NAME"></a>C.2.82 Scale "SCALE1" is not valid. We will substitute a dummy scale based on "SCALE2". See 'Help|Recent Messages' for details.</h1> +<p> +SCALE1 is not one of known scales defined in "xtrkcad.xtq". We will substitute the layout scale info from SCALE2. +</p> +<p> +If the current scale is not correct, then select it on 'Options|Layout' and reload your layout. +</p> +<p> +You can also correct this by selecting the affected tracks, and using the 'Change|Change Scale' <a href="cmdRescale.html#cmdRescale">section 2.2.1</a> command. +</p> +<p> +Please report this error to the <em>XTrackCAD</em> project development team at SourceForge. The process for reporting errors is outlined in <a href="bugs.html#bugs">section 1.11.1</a>. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Scale index (NNN) is not valid. Do you want use the current layout scale (SCALE)? Or create an "Unknown" scale? See 'Help|Recent Messages' for details.</title> +<link rel="previous" href="MSG_BAD_SCALE_NAME.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_2ND_TRK_NOT_SEL_UNSEL.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_BAD_SCALE_INDEX"></a>C.2.83 Scale index (NNN) is not valid. Do you want use the current layout scale (SCALE)? Or create an "Unknown" scale? See 'Help|Recent Messages' for details.</h1> +<p> +Internal error: an invalid scale index has been generated. You can substitute the layout's current scale (recommended). +</p> +<p> +If you do not want to use the currrent scale: +</p> +<ul><li> +Choose "Unknown". +</li> +<li> +Save your file +</li> +<li> +Choose the correct scale from 'Options|Layout' +</li> +<li> +Reload your file +</li> +<li> +You will see a notice that "Scale Unknown is invalid" +</li> +<li> +Choose the layout scale +</li> +</ul> +<p> +You can also correct this by selecting the affected tracks, and using the 'Change|Change Scale' <a href="cmdRescale.html#cmdRescale">section 2.2.1</a> command. +</p> +<p> +Please report this error to the <em>XTrackCAD</em> project development team at SourceForge. The process for reporting errors is outlined in <a href="bugs.html#bugs">section 1.11.1</a>. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Second track must be selected|unselected</title> +<link rel="previous" href="MSG_BAD_SCALE_INDEX.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_SEL_POS_FIRST.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_2ND_TRK_NOT_SEL_UNSEL"></a>C.2.84 Second track must be selected|unselected</h1> +<p> +The <strong>Move To Join</strong> command moves the selected tracks so an <em>endpoint</em> is joined with the <em>endpoint</em> of an unselected track. If you choose the selected <em>endpoint</em> first then you must choose an unselected <em>endpoint</em> second, and vice versa. +</p> +<p> +Refer to <a href="joinTrackMove.html#joinTrackMove">section 2.2.7.7</a> for detail. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Select position prior to entering Text.</title> +<link rel="previous" href="MSG_2ND_TRK_NOT_SEL_UNSEL.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_OUT_OF_BOUNDS.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_SEL_POS_FIRST"></a>C.2.85 Select position prior to entering Text.</h1> +<p> +The position where text is to be placed on the layout must be selected prior to text entry. The position is select by <em>Left-Click</em>ing on the layout at the point where the text is to appear. Desired text is entered after the position is selected. If necessary, the location can be changed once text entry begins by <em>Left-Click+Drag</em>ing the text to any desired position on the layout. +</p> +<p> +Refer to <a href="cmdText.html#cmdText">section 2.3.9</a> for detail. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Selected page is out of bounds.</title> +<link rel="previous" href="MSG_SEL_POS_FIRST.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_CARPROTO_BADSEGS.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_OUT_OF_BOUNDS"></a>C.2.86 Selected page is out of bounds.</h1> +<p> +During execution of the <strong>Print</strong> command an attempted was made to select a page that's outside the layouts boundaries. +</p> +<p> +Refer to <a href="cmdLayout.html#cmdLayout">section 2.10.6</a> for detail regarding layout boundaries or <a href="cmdPrint.html#cmdPrint">section 2.5.9</a> for detail regarding the <strong>Print</strong> command. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Selected shapes must define a rectangular area ...</title> +<link rel="previous" href="MSG_OUT_OF_BOUNDS.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_TOO_FAR_APART_DIVERGE.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_CARPROTO_BADSEGS"></a>C.2.87 Selected shapes must define a rectangular area ...</h1> +<p> +The <strong>Import</strong> command (Button) on the <strong>Car Prototype</strong> dialog is used to create the image of an car from the shapes selected on the layout prior to opening the <strong>Car Prototype</strong> dialog. The car is assumed to be oriented horizontally so its length must be greater than its height. The selected shapes do not meet this requirement. +</p> +<p> +Refer to <a href="carprototype.html#carprototype">section 2.9.1.3</a> for detail. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Selected tracks deviate too much or are too far apart from each other.</title> +<link rel="previous" href="MSG_CARPROTO_BADSEGS.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_COMMAND_DISABLED.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_TOO_FAR_APART_DIVERGE"></a>C.2.88 Selected tracks deviate too much or are too far apart from each other.</h1> +<p> +The <strong>Connect</strong> command is used to remove small gaps that may result when using sectional track. The chosen sectional track <em>endpoints</em> must be close together and nearly aligned. The selected tracks deviate too much or are too far apart from each other. +</p> +<p> +Refer to <a href="cmdConnect.html#cmdConnect">section 2.2.3</a> for detail. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Specified command disabled.</title> +<link rel="previous" href="MSG_TOO_FAR_APART_DIVERGE.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_SPLIT_POS_BTW_MERGEPTS.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_COMMAND_DISABLED"></a>C.2.89 Specified command disabled.</h1> +<p> +The specified command has been disabled in error. +</p> +<p> +Please report this error to the <em>XTrackCAD</em> project development team at SourceForge. The process for reporting errors is outlined in <a href="bugs.html#bugs">section 1.11.1</a>. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Split position between Turnout Points</title> +<link rel="previous" href="MSG_COMMAND_DISABLED.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_SPLIT_PATH_NOT_UNIQUE.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_SPLIT_POS_BTW_MERGEPTS"></a>C.2.90 Split position between Turnout Points</h1> +<p> +The <strong>Split</strong> position must be between an endpoint and the position where the turnout's track segments diverge (the turnout points). Select a position closer to the endpoint. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Split position not on unique path</title> +<link rel="previous" href="MSG_SPLIT_POS_BTW_MERGEPTS.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_RADIUS_TOO_BIG.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_SPLIT_PATH_NOT_UNIQUE"></a>C.2.91 Split position not on unique path</h1> +<p> +The <strong>Split</strong> position must be between an endpoint and the position where the turnout's track segments diverge (the turnout points). Select a position closer to the endpoint. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>The Circle or Helix will not fit within the layouts room parameters (Height and Width).</title> +<link rel="previous" href="MSG_SPLIT_PATH_NOT_UNIQUE.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_NOT_UNFROZEN_LAYER.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_RADIUS_TOO_BIG"></a>C.2.92 The Circle or Helix will not fit within the layouts room parameters (Height and Width).</h1> +<p> +The defined circle can not fit within the defined layout parameters. Either specify a smaller value in the <strong>Radius</strong> field, or increase the room parameters in the <strong>Layout</strong> dialog. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>The current layer was defined as frozen. It is now unfrozen.</title> +<link rel="previous" href="MSG_RADIUS_TOO_BIG.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_TODSGN_CORNU_TOO_COMPLEX.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_NOT_UNFROZEN_LAYER"></a>C.2.93 The current layer was defined as frozen. It is now unfrozen.</h1> +<p> +The current layer has to be unfrozen +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>The curves created by the Turnout Designer for a cornu curve have more than 128 segments....</title> +<link rel="previous" href="MSG_NOT_UNFROZEN_LAYER.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_ENTERED_STRING_TRUNCATED.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_TODSGN_CORNU_TOO_COMPLEX"></a>C.2.94 The curves created by the Turnout Designer for a cornu curve have more than 128 segments....</h1> +<p> +Too complex a curve set to be used. Respecify <strong>Turnout Designer</strong> values. +</p> +<p> +Refer to <a href="cmdTurnoutNew.html#cmdTurnoutNew">section 2.9.9</a> for detail. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>The entered text is too long. Maximum length is %d.</title> +<link rel="previous" href="MSG_TODSGN_CORNU_TOO_COMPLEX.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_TEXT_TOO_LONG.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_ENTERED_STRING_TRUNCATED"></a>C.2.95 The entered text is too long. Maximum length is %d.</h1> +<p> +The text entered into a field is longer than the maximum allowed length and was truncated. Please check the shortened text and edit as necessary. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>The entered text was too long for the text object. It was truncated.</title> +<link rel="previous" href="MSG_ENTERED_STRING_TRUNCATED.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_CARIMP_MISSING_PARTNO.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_TEXT_TOO_LONG"></a>C.2.96 The entered text was too long for the text object. It was truncated.</h1> +<p> +Text objects are limited to about 10k characters. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>The following car has no Part Number...</title> +<link rel="previous" href="MSG_TEXT_TOO_LONG.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_CARIMP_MISSING_DIMS.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_CARIMP_MISSING_PARTNO"></a>C.2.97 The following car has no Part Number...</h1> +<p> +The car import file must contain headers for at least the <em>Scale</em>, <em>Prototype</em>, <em>Manufacturer</em> and <em>Partno</em> columns. In addition, car information relative to these columns must be included in each line of the file otherwise this error will occur. +</p> +<p> +Refer to <a href="cmdCarinv.html#cmdCarinv">section 2.9.1</a> for detail. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>The following car has no dimensions and a...</title> +<link rel="previous" href="MSG_CARIMP_MISSING_PARTNO.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_CARIMP_IGNORED_COLUMN.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_CARIMP_MISSING_DIMS"></a>C.2.98 The following car has no dimensions and a...</h1> +<p> +The car import file does not specify car dimensions and the specified <em>Partno</em> can not be found. Edit the import file and either add car dimensions or add/update the <em>Partno</em>. This will allow <em>XTrackCAD</em> to locate information for the car being imported. +</p> +<p> +Refer to <a href="cmdCarinv.html#cmdCarinv">section 2.9.1</a> for detail. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>The following column in the Car Import file will be ignored:...</title> +<link rel="previous" href="MSG_CARIMP_MISSING_DIMS.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_CANT_MOVE_UNDER_TRAIN.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_CARIMP_IGNORED_COLUMN"></a>C.2.99 The following column in the Car Import file will be ignored:...</h1> +<p> +An invalid column in the Car Import file will be ignored. Valid column names are: +</p> +<p> +<em>Index</em>, <em>Scale</em>, <em>Manufacturer</em>, <em>Type</em>, <em>Partno</em>, <em>Prototype</em>, <em>Description</em>, <em>Roadname</em>, <em>Repmark</em>, <em>Number</em>, <em>Options</em>, <em>CarLength</em>, <em>CarWidth</em>, <em>CoupledLength</em>, <em>TruckCenter</em>, <em>Color</em>, <em>PurchPrice</em>, <em>CurrPrice</em>, <em>Condition</em>, <em>PurchDate</em>, <em>ServiceDate</em> and <em>Notes</em>. +</p> +<p> +Refer to <a href="cmdCarinv.html#cmdCarinv">section 2.9.1</a> for detail. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>The position of a turnout or turntable cannot be changed while occupied by a train.</title> +<link rel="previous" href="MSG_CARIMP_IGNORED_COLUMN.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_SPLITTED_OBJECT_TOO_SHORT.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_CANT_MOVE_UNDER_TRAIN"></a>C.2.100 The position of a turnout or turntable cannot be changed while occupied by a train.</h1> +<p> +The position of a turnout or turntable cannot be changed while occupied by a train. +</p> +<p> +Refer to <a href="cmdTrain.html#cmdTrain">section 2.9.8</a>, <em>Turnouts and Turntables</em> for detail. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>The resulting length of one track piece is shorter than the minimum length of %d.</title> +<link rel="previous" href="MSG_CANT_MOVE_UNDER_TRAIN.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_STRUCT_NO_STRUCTS.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_SPLITTED_OBJECT_TOO_SHORT"></a>C.2.101 The resulting length of one track piece is shorter than the minimum length of %d.</h1> +<p> +After the split one of the track segments will be shorter than the minimum length. Select a different position for splitting. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>There are no structures to choose from in the structure...</title> +<link rel="previous" href="MSG_SPLITTED_OBJECT_TOO_SHORT.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_TURNOUT_NO_TURNOUT.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_STRUCT_NO_STRUCTS"></a>C.2.102 There are no structures to choose from in the structure...</h1> +<p> +This error occurs when; +</p> +<ul><li> +no structures are available in the structure selection list or; +</li> +<li> +the scale setting of the layout and <strong>Parameter File</strong>s does not match. +</li> +</ul> +<p> +Using the <strong>File>Parameter Files</strong> menu, check which Parameter files are loaded. Ensure the scale of the loaded files match that of the layout. Alternately a new Structure could be created using the <strong>Group</strong> command. +</p> +<p> +Refer to <a href="cmdPrmfile.html#cmdPrmfile">section 2.5.7</a> for detail regarding <strong>Parameter File</strong>s or <a href="cmdGroup.html#cmdGroup">section 2.9.4</a> for detail regarding the <strong>Group</strong> command. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>There are no turnouts to choose from in the turnout...</title> +<link rel="previous" href="MSG_STRUCT_NO_STRUCTS.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_NO_UNCONN_EP.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_TURNOUT_NO_TURNOUT"></a>C.2.103 There are no turnouts to choose from in the turnout...</h1> +<p> +This error occurs when; +</p> +<ul><li> +no turnouts are available in the turnouts selection list or; +</li> +<li> +the scale setting of the layout and <strong>Parameter File</strong>s does not match. +</li> +</ul> +<p> +Using the <strong>File>Parameter Files</strong> menu, check which Parameter files are loaded. Ensure the scale of the loaded files match that of the layout. Alternately a new turnout could be created using the <strong>Turnout Designer</strong> command. +</p> +<p> +Refer to <a href="cmdPrmfile.html#cmdPrmfile">section 2.5.7</a> for detail regarding <strong>Parameter File</strong>s or <a href="cmdTurnoutNew.html#cmdTurnoutNew">section 2.9.9</a> for detail regarding the <strong>Turnout Designer</strong> command. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>There are no unconnected end points for this track</title> +<link rel="previous" href="MSG_TURNOUT_NO_TURNOUT.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_PULL_FEW_SECTIONS.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_NO_UNCONN_EP"></a>C.2.104 There are no unconnected end points for this track</h1> +<p> +The current command operates on the unconnected <em>endpoint</em> of a track, but the <em>endpoints</em> of the chosen track are all connected to other tracks. Use the <strong>Split</strong> command to disconnect the desired <em>endpoint</em> of this track or choose another track. +</p> +<p> +Refer to <a href="cmdSplitTrack.html#cmdSplitTrack">section 2.2.17.1</a> for detail. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>There are too few sections in this loop.</title> +<link rel="previous" href="MSG_NO_UNCONN_EP.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_NO_REDO.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_PULL_FEW_SECTIONS"></a>C.2.105 There are too few sections in this loop.</h1> +<p> +The <strong>Connect</strong> command operates by adding small gaps between other track to make up for the larger gap between the tracks you have selected. In this case you are attempting to close a loop of track with to few sections. Try creating a loop with more sectional track pieces. +</p> +<p> +Refer to <a href="cmdConnect.html#cmdConnect">section 2.2.3</a> for detail. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>There is nothing to redo!</title> +<link rel="previous" href="MSG_PULL_FEW_SECTIONS.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_NO_UNDO.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_NO_REDO"></a>C.2.106 There is nothing to redo!</h1> +<p> +Either the <strong>Undo</strong> command has not been used or another command has been used since, thus no Undo operations are available to be undone. +</p> +<p> +Refer to <a href="cmdUndo.html#cmdUndo">section 2.4.9</a> for detail. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>There is nothing to undo!</title> +<link rel="previous" href="MSG_NO_REDO.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_TOOMANYSEGSINGROUP.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_NO_UNDO"></a>C.2.107 There is nothing to undo!</h1> +<p> +Either no operations have been performed since the current file was opened or all previous operations (up to 10) have been undone. +</p> +<p> +Refer to <a href="cmdUndo.html#cmdUndo">section 2.4.9</a> for detail. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Too many track segments in Group.</title> +<link rel="previous" href="MSG_NO_UNDO.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_CANNOT_CHANGE.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_TOOMANYSEGSINGROUP"></a>C.2.108 Too many track segments in Group.</h1> +<p> +A group is limited to a maximum of 127 track segments. The number of track segments within the selected group of tracks exceed this number. Select a smaller number of tracks then try again. +</p> +<p> +Refer to <a href="cmdGroup.html#cmdGroup">section 2.9.4</a> for details. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Track cannot be changed.</title> +<link rel="previous" href="MSG_TOOMANYSEGSINGROUP.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_POINT_INSIDE_TURNTABLE.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_CANNOT_CHANGE"></a>C.2.109 Track cannot be changed.</h1> +<p> +Modifications can only be made to straight or curved tracks. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Track endpoint is within turntable radius.</title> +<link rel="previous" href="MSG_CANNOT_CHANGE.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_MOVE_POINTS_AWAY_NO_INTERSECTION.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_POINT_INSIDE_TURNTABLE"></a>C.2.110 Track endpoint is within turntable radius.</h1> +<p> +An attempt has been made to create the <em>endpoint</em> of a track within the radius of the <strong>Turntable</strong>. Move the <em>endpoint</em> of the track (mouse pointer) outside of the radius of the <strong>Turntable</strong>. +</p> +<p> +Refer to <a href="cmdTurntable.html#cmdTurntable">section 2.1.9</a> for detail. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Track intersection not possible; move points away from frog.</title> +<link rel="previous" href="MSG_POINT_INSIDE_TURNTABLE.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_TRK_TOO_SHORT.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_MOVE_POINTS_AWAY_NO_INTERSECTION"></a>C.2.111 Track intersection not possible; move points away from frog.</h1> +<p> +The track angle at the current point position does not intersect with the angle of the diverging leg of the new turnout. The points need to be relocated to a position that will allow the angle of the track to intersect the angle of the diverging leg of the new turnout. +</p> +<p> +Refer to <a href="cmdHandLaidTurnout.html#cmdHandLaidTurnout">section 2.1.3</a> for detail. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Track is too short by N.NNN</title> +<link rel="previous" href="MSG_MOVE_POINTS_AWAY_NO_INTERSECTION.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_RADIUS_LSS_EASE_MIN.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_TRK_TOO_SHORT"></a>C.2.112 Track is too short by N.NNN</h1> +<p> +The operation will create a track that is shorter than the minimum length specified on the <strong>Preferences</strong> dialog. Adjust the position of the mouse to increase the length of the track by moving away from the <em>endpoint</em>. +</p> +<p> +Refer to <a href="cmdPref.html#cmdPref">section 2.10.7</a> for detail. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Track radius (N.NNN) is smaller than easement minimum (N.NNN).</title> +<link rel="previous" href="MSG_TRK_TOO_SHORT.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_SEGMENT_NOT_ON_PATH.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_RADIUS_LSS_EASE_MIN"></a>C.2.113 Track radius (N.NNN) is smaller than easement minimum (N.NNN).</h1> +<p> +An attempt was made to create a curved track with a radius smaller than the minimum specified in the <strong>Easement</strong> dialog. Try moving the mouse to different position, creating a curve with a larger radius. +</p> +<p> +Refer to <a href="cmdEasement.html#cmdEasement">section 2.10.4</a> for detail. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Track segment N not on Path for Turnout</title> +<link rel="previous" href="MSG_RADIUS_LSS_EASE_MIN.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_TOOMANYSEGSINGROUP2.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_SEGMENT_NOT_ON_PATH"></a>C.2.114 Track segment N not on Path for Turnout</h1> +<p> +A Path (a sequence of track segments) defines a route through a Turnout from one End Point to another. Each segment should be be present in a least one Path. +</p> +<p> +This can happen when Grouping complex track objects, or when there is more than one path between End Points, for example a siding. +</p> +<p> +Try simplifying the segments or removing any loops in the connected segments. +</p> +<p> +This message can be suppressed by passing the command line option +</p> +<ul><li> +/d suppresscheckpaths (Windows) or +</li> +<li> +-d suppresscheckpaths (Linux/MAC) +</li> +</ul> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Track segments appear too late in Group segment list.</title> +<link rel="previous" href="MSG_SEGMENT_NOT_ON_PATH.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_CANT_MODIFY_FROZEN_TRK.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_TOOMANYSEGSINGROUP2"></a>C.2.115 Track segments appear too late in Group segment list.</h1> +<p> +A Group's track segments must be in the first 127 segments. You can move the track segments to the start of the segment list. +</p> +<p> +Refer to <a href="cmdGroup.html#cmdGroup">section 2.9.4</a> for details. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Tracks in a frozen layer cannot be modified.</title> +<link rel="previous" href="MSG_TOOMANYSEGSINGROUP2.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_CANT_MODIFY_MODULE_TRK.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_CANT_MODIFY_FROZEN_TRK"></a>C.2.116 Tracks in a frozen layer cannot be modified.</h1> +<p> +This operation cannot be executed as the selected track is present on a frozen layer. Track modifications may be performed only on unfrozen layers. Move the object to a <strong>Layer</strong> that's not frozen or unfreeze the layer. +</p> +<p> +Refer to <a href="cmdLayer.html#cmdLayer">section 2.9.5</a> for detail. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Tracks in a module cannot be modified.</title> +<link rel="previous" href="MSG_CANT_MODIFY_FROZEN_TRK.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_SEGMENTS_DIFFER.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_CANT_MODIFY_MODULE_TRK"></a>C.2.117 Tracks in a module cannot be modified.</h1> +<p> +This operation cannot be executed as the selected track is present in a module layer. Track modifications may be performed only on unfrozen, non-module layers. +</p> +<p> +Refer to <a href="cmdLayer.html#cmdLayer">section 2.9.5</a> for detail. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Turnout definition contains non-track segments....</title> +<link rel="previous" href="MSG_CANT_MODIFY_MODULE_TRK.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_TURNTABLE_DIAM_GTR_0.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_SEGMENTS_DIFFER"></a>C.2.118 Turnout definition contains non-track segments....</h1> +<p> +Turnout definitions can include lines and other shapes that represent switch machines, switch stands, roadbed or other objects. Such items can be include when editing Turnout definitions. These same items can also be removed if there's a need to start over again. +</p> +<p> +Refer to <a href="cmdCustmgm.html#cmdCustmgm">section 2.9.2</a> for detail. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Turntable diameter must greater than 0.</title> +<link rel="previous" href="MSG_SEGMENTS_DIFFER.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_UNDO_ASSERT.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_TURNTABLE_DIAM_GTR_0"></a>C.2.119 Turntable diameter must greater than 0.</h1> +<p> +It's not possible to create a turntable with a diameter of less than or equal to 0. Specify a positive value in the <strong>Diameter</strong> field that appears in the Status Bar. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Undo assertion failure %s:%d...</title> +<link rel="previous" href="MSG_TURNTABLE_DIAM_GTR_0.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_LAYOUT_LINES_SKIPPED.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_UNDO_ASSERT"></a>C.2.120 Undo assertion failure %s:%d...</h1> +<p> +Please report this error to the <em>XTrackCAD</em> project development team at SourceForge. The process for reporting errors is outlined in <a href="bugs.html#bugs">section 1.11.1</a>. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>While processing Layout file %s, %d lines were skipped because they were not recognized.</title> +<link rel="previous" href="MSG_UNDO_ASSERT.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_PARAM_LINES_SKIPPED.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_LAYOUT_LINES_SKIPPED"></a>C.2.121 While processing Layout file %s, %d lines were skipped because they were not recognized.</h1> +<p> +The layout file that you loaded contained records that were not recognized. This could be because the file was written by a higher level of <em>XTrackCAD</em> or because it was corrupted. +</p> +<p> +Take full advantage of the latest features within <em>XTrackCAD</em> by visiting the <a href="http://www.xtrkcad.org/" target="_blank"><em>XTrackCAD</em> Fork Website</a> and downloading the latest release. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>While processing Parameter file %s, %d lines were skipped because they were not recognized.</title> +<link rel="previous" href="MSG_LAYOUT_LINES_SKIPPED.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_BETA_NOTICE.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_PARAM_LINES_SKIPPED"></a>C.2.122 While processing Parameter file %s, %d lines were skipped because they were not recognized.</h1> +<p> +The parameter file that you loaded contained records that were not recognized. This could be because the file was designed for a higher level of <em>XTrackCAD</em> or because it was corrupted. +</p> +<p> +Take full advantage of the latest features within <em>XTrackCAD</em> by visiting the <a href="http://www.xtrkcad.org/" target="_blank"><em>XTrackCAD</em> Fork Website</a> and downloading the latest release. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>XTrackCAD Version %s: Please note that this Beta Version of XTrackCAD is still undergoing final testing before its official release. The sole purpose of this Beta Version is to conduct testing and obtain feedback. Should you encounter any bugs, glitches, lack of functionality or other problems, please let us know immediately so we can rectify these accordingly. Your help in this regard is greatly appreciated!</title> +<link rel="previous" href="MSG_PARAM_LINES_SKIPPED.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_BITMAP_SIZE_WARNING.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_BETA_NOTICE"></a>C.2.123 XTrackCAD Version %s: Please note that this Beta Version of XTrackCAD is still undergoing final testing before its official release. The sole purpose of this Beta Version is to conduct testing and obtain feedback. Should you encounter any bugs, glitches, lack of functionality or other problems, please let us know immediately so we can rectify these accordingly. Your help in this regard is greatly appreciated!</h1> +<p> +XTrackCAD Version %s: Please note that this Beta Version of XTrackCAD is still undergoing final testing before its official release. The sole purpose of this Beta Version is to conduct testing and obtain feedback. Should you encounter any bugs, glitches, lack of functionality or other problems, please let us know immediately so we can rectify these accordingly. Your help in this regard is greatly appreciated! +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>You have specified a large bitmap....</title> +<link rel="previous" href="MSG_BETA_NOTICE.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="MSG_PT_IS_NOT_TRK.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_BITMAP_SIZE_WARNING"></a>C.2.124 You have specified a large bitmap....</h1> +<p> +Bitmaps can use a large amount of system resources. They may also take a long time to generate and create a large file. +</p> +<p> +Refer to <a href="cmdOutputbitmap.html#cmdOutputbitmap">section 2.5.2</a> for detail. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>[X Y] is not a track</title> +<link rel="previous" href="MSG_BITMAP_SIZE_WARNING.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="upgrades.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="MSG_PT_IS_NOT_TRK"></a>C.2.125 [X Y] is not a track</h1> +<p> +The current command operates on a track object and a track was not found at the current location (given as X and Y). +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Upgrade From Earlier XTrackCAD Version</title> +<link rel="previous" href="MSG_PT_IS_NOT_TRK.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="v5.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="upgrades"></a>Appendix D: Upgrade From Earlier <em>XTrackCAD</em> Version</h1> +<p> +This section contains helpful information regarding program changes and the effects such may have with respect to layout files made with previous versions of <em>XTrackCAD</em>. +</p> +<hr> +<ul> +<li><a href="v5.html#v5">D.1 Version 5.x</a></li> +<li><a href="cmdUpdatetitle.html#cmdUpdatetitle">D.2 Version 2.x</a></li> +<li><a href="v4.0.3_revisions.html#v4.0.3_revisions">D.3 Version 4.0.3</a></li> +<li><a href="v4.0.x_revisions.html#v4.0.x_revisions">D.4 Version 4.0.x</a></li> +</ul> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Version 5.x</title> +<link rel="previous" href="upgrades.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="cmdUpdatetitle.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="v5"></a>D.1 Version 5.x</h1> +<p> +Version 5.x.x of XTrackCAD introduced many enhancements an additions including Layout Control Objects, Cornu Tracks and Bezier Tracks and Lines. It is upward compatible from earlier versions but if the new objects are included in layouts, the files will not be readable by earlier versions. +</p> +<p> +Users should take a backup of thier Layout files if they will want to use the previous level of code before opening them. +</p> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Version 2.x</title> +<link rel="previous" href="v5.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="v4.0.3_revisions.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="cmdUpdatetitle"></a>D.2 Version 2.x</h1> +<p> +<strong>Updated Titles</strong> +</p> +<p> +<img src="png.d/updttl.png"> +</p> +<p> +Version 2.0.0 of <em>XTrkCad</em> introduced a change in the way Turnouts and Structures are named. The new method splits the title into 3 parts: Manufacturer, Description and Part Number. +</p> +<p> +To help you when upgrading to the new version, when loading an old <em>XTrkCad</em> layout file, <em>XTrackCAD</em> detects if the layout uses Turnouts and Structures that have titles in the old format. If so this dialog is displayed which allows you to change the titles in your layout to the new format. +</p> +<p> +The title of each different type of Turnout is collected and presented in this dialog. Simply select the Turnout on the list that matches the one displayed and click 'Update'. Repeat for each type of Turnout in your layout. +</p> +<p> +If there is no matching Turnout, click on Ignore. The Turnout will retain the old name as the Description, with a blank Manufacturer and Part Number. +</p> +<p> +Click Cancel to continue loading the file without updating the titles. +</p> +<p> +If you Save your file without updating all the titles you will not be able to update the titles later. +</p> +<p> +If you are looking at old files without making changes then Click on Cancel to load the file without Updates. +</p> +<p> +Not updating the titles prevents the customization of the way titles are presented in various lists and on the layout. Basic operation of <em>XTrackCAD</em> is not affected. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Version 4.0.3</title> +<link rel="previous" href="cmdUpdatetitle.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="v4.0.x_revisions.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="v4.0.3_revisions"></a>D.3 Version 4.0.3</h1> +<p> +<strong>Internationalization</strong> +</p> +<p> +Internationalization or the ability to localize <em>XTrackCAD</em> for use with various languages was adopted during this version upgrade. <em>XTrackCAD</em> is now available with balloon help and daily tips written in US English, Finnish and German. The <em>XTrackCAD</em> development team welcomes anyone who wishes to volunteer with translation of various support files. Let them know by submitting an offer to assist to the <em>XTrackCAD</em> <strong>Feature Tracker</strong> located at the <a href="http://sourceforge.net/tracker/?group_id=151737&atid=781981" target="_blank"><em>XTrackCAD</em> Fork Project Site</a> or the <em>XTrackCAD</em> <strong>Wikka Wish List</strong> located at the <a href="http://www.xtrkcad.org/Wikka/WishList" target="_blank"><em>XTrackCAD</em> Wiki: WishList</a>. +</p> +<p> +<strong>Minor Fixes and Enhancements</strong> +</p> +<ul><li> +Thanks to Martin Fischer, the Button Bar has a much cleaner and sharper look. +</li> +</ul> +<p> + +</p> +<ul><li> +Several selections within various Option Menus (Layout, Display, Command and Preferences) have been re-arranged. In some case the order or grouping of menu items changed. In other cases menu items were move to a different menu; still within the sub-set of Option Menus. Our hope is that we've made it easier to locate parameter settings that in past were difficult to locate. +</li> +</ul> +<p> + +</p> +<ul><li> +An new option that allows <em>XTrackCAD</em> to automatically re-open the last layout file has been added to the <strong>Options>Preferences</strong> menu. For detail refer to the ‘On Program Startup’ item found in <a href="cmdPref.html#cmdPref">Section 2.10.7</a>. +</li> +</ul> +<p> + +</p> +<ul><li> +Significant updates were made to the Atlas N and HO scale parameter files. Diesel engine and freight car information is now contained in four separate parameter files; Atlas HO Scale Cars (<em>atlascho.xtp</em>), Atlas HO Scale Diesel Engines (<em>atlaseho.xtp</em>), Atlas N Scale Cars (<em>atlascn.xtp</em>) and Atlas N Scale Diesel Engines (<em>atlasen.xtp</em>). +</li> +</ul> +<p> + +</p> +<ul><li> +Twenty-one prototypes were added to the American Prototype parameter file (<em>protoam.xtp</em>). The additional prototypes are; +<p> + +</p> +<ul><li> +Diesel Engines +<ul><li> +Dash 8-32BWH, Dash 8-40B, Dash 8-40BW, Dash 8-40C +</li> +<li> +FP7A +</li> +<li> +H15-44, H16-44, H15/16-44 +</li> +<li> +RS4/5 +</li> +<li> +RSD12 +</li> +<li> +S1, S2, S3, S4 +</li> +<li> +SD35, SDP35 +</li> +</ul> + +</li> +</ul> +<p> + +</p> +<ul><li> +Freight Cars +<ul><li> +Caboose, NE-6 +</li> +<li> +Flat, 42' +</li> +<li> +Tank, 55' and Tank, 65' +</li> +<li> +Reefer, 36' +</li> +</ul> + +</li> +</ul> + +</li> +</ul> +<p> + +</p> +<ul><li> +<em>XTrackCAD</em> users reported difficulty when attempting to activate grid lines in version 4.02. The problem was noticeable only on new installations. A default grid size of zero was found to be the cause of the problem. The default grid size has been changed to 1 thus eliminating the problem. +</li> +</ul> +<p> + +</p> +<ul><li> +A small bug preventing Zooms of less than 1:1 (Refer to <a href="cmdZoom.html#cmdZoom">Section 2.12.4</a> for detail.) was accidentally introduced in version 4.0.1. This problem has been corrected in version 4.0.3. +</li> +</ul> +<p> + +</p> +<ul><li> +When new scale definitions were added to XTrkCad 4.0.2, a small bug broke the file format for some scales (eg., N UK). This problem has been corrected in version 4.0.3. +</li> +</ul> +<p> + +</p> +<ul><li> +Some users of the Linux based application reported the <em>Sticky Commands</em> menu would exceed screen length. Spacing between <em>Sticky Commands</em> options has been improved in order to prevent this problem. +</li> +</ul> +<p> + +</p> +<ul><li> +We've no idea when certain demo's broke however thanks to the work of Mikko Nissinen, many broken demos are now fixed. +</li> +</ul> +<p> + +</p> +<p> +<strong>Name Change</strong> +</p> +<p> +With release of this version of <em>XTrackCAD</em> there's been a subtle change in the spelling and punctuation of the applications name. From this version forward, the application will be know as <em>XTrackCAD</em>. Please note the spelling and capitalization of the name. +</p> +<p> +Why was the name changed? This release gives <em>XTrackCAD</em> developers an opportunity to included a much sought after feature; Internationalization (Through i18n). On the surface this doesn't sound that big however having the ability to internationalize or localize the product has great advantages for all users. Not only is there great potential for the application to become available to a larger audience, our hope it that the developer pool will expand which should result in more features being added to the application. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Version 4.0.x</title> +<link rel="previous" href="v4.0.3_revisions.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="warrantyLicenseCopy.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"><meta name="AppleTitle" content="Warranty" /> +</head> +<body> +<h1><a name="v4.0.x_revisions"></a>D.4 Version 4.0.x</h1> +<p> +<strong>Check-point Files</strong> +</p> +<p> +Version 4 of <em>XTrkCad</em> introduces a new way of handling check-point files. This will allow resuming your work after a system crash much easier than before. +</p> +<p> +If you start <em>XTrkCad</em> V.4.0.x the first time after an upgrade from a earlier version, a pop-up with the question: "Program was not terminated properly. Do you want to resume working on the previous track plan?" +</p> +<p> +Select "Ignore" only if you're sure that the work from your last session has been correctly saved. If uncertain or restarting after an earlier failure select "Resume". +</p> +<p> + +</p> +<p> +<strong>Help System</strong> +</p> +<p> +The built in help system has been converted to a much more flexible and widely used HTML format. With many new graphics and extensively rewritten text the help information is now up-to-date with recent development. +</p> +<p> +<strong>Layer Colour Settings</strong> +</p> +<p> +Your personal layer color settings are now stored in your preferences. This allows you to apply the same settings to other layouts you design. +</p> +<p> +<strong>Parameter Files Updated</strong> +</p> +<p> +Thanks to Ralph Boyd, Dwayne Ward, Casey Sterbenz and others, many new and updated parameter files were added to this release. +</p> +<p> +<strong>Wheel mouse</strong> +</p> +<p> +The wheel on a wheel mouse can now be used to zoom in and out on a layout design. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Warranty, License and Copying</title> +<link rel="previous" href="v4.0.x_revisions.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="warranty.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="warrantyLicenseCopy"></a>Appendix E: Warranty, License and Copying</h1> +<p> +<em>XTrackCAD</em> is Copyright 2003, Sillub Technology and Copyright 2007, Bob Blackwell and Martin Fischer and Copyright 2020, Martin Fischer, Adam Richards and Dave Bullis. +</p> +<p> +Some icons are taken from the <a href="http://tango.freedesktop.org/" target="_blank">Tango Free Desktop</a> project and are covered by the Creative Commons Attribution-ShareAlike 2.5 License Agreement. +</p> +<hr> +<ul> +<li><a href="warranty.html#warranty">E.1 Warranty</a></li> +<li><a href="copydist.html#copydist">E.2 Copying and Distribution</a></li> +<li><a href="GNUGPLicense.html#GNUGPLicense">E.3 GNU General Public License License</a></li> +<li><a href="Contributions.html#Contributions">E.4 Contributions</a></li> +</ul> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Warranty</title> +<link rel="previous" href="warrantyLicenseCopy.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="copydist.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="warranty"></a>E.1 <a name="i0"></a>Warranty</h1> +<p> +<em>XTrackCAD</em> is provided "as is" without warranty of any kind, either express or implied, including, but not limited to warranties of merchantability or fitness for a particular purpose. In no event will Sillub Technology be liable for any damages, including incidental or consequential damages, arising out of the use of the program, even if advised of the possibility of such damages. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Copying and Distribution</title> +<link rel="previous" href="warranty.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="GNUGPLicense.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="copydist"></a>E.2 <a name="i0"></a>Copying and Distribution</h1> +<p> +<em>XTrackCAD</em> is a powerful CAD program for designing Model Railroad layouts. +</p> +<p> +<em>XTrackCAD</em> is Copyright 2003, Sillub Technology and Copyright 2007, Bob Blackwell and Martin Fischer and Copyright 2020, Martin Fischer, Adam Richards and Dave Bullis and licensed as free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. +</p> +<p> +You should have received a copy of the GNU General Public License along with this program; see the file named COPYING or refer to <a href="GNUGPLicense.html#GNUGPLicense">Section E.3</a>. If not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA +</p> +<p> +<em>XTrackCAD</em> Fork is a project for further development of the original <em>XTrackCAD</em> software. Refer to the project homepage at http://www.xtrkcad.org/ for news and current releases. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>GNU General Public License License</title> +<link rel="previous" href="copydist.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="Contributions.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="GNUGPLicense"></a>E.3 <a name="i0"></a>GNU General Public License <a name="i1"></a>License</h1> +<dl><dd> +GNU GENERAL PUBLIC LICENSE +</dd> +<dd> +Version 2, June 1991 +</dd> +</dl> +<p> + +</p> +<dl><dd> +Copyright (C) 1989, 1991 Free Software Foundation, Inc. +</dd> +<dd> +51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA +</dd> +</dl> +<p> +Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed. +</p> +<p> +<em>Preamble</em> +</p> +<p> +The licenses for most software are designed to take away your freedom to share and change it. By contrast, the GNU General Public License is intended to guarantee your freedom to share and change free software--to make sure the software is free for all its users. This General Public License applies to most of the Free Software Foundation's software and to any other program whose authors commit to using it. (Some other Free Software Foundation software is covered by the GNU Lesser General Public License instead.) You can apply it to your programs, too. +</p> +<p> +When we speak of free software, we are referring to freedom, not price. Our General Public Licenses are designed to make sure that you have the freedom to distribute copies of free software (and charge for this service if you wish), that you receive source code or can get it if you want it, that you can change the software or use pieces of it in new free programs; and that you know you can do these things. +</p> +<p> +To protect your rights, we need to make restrictions that forbid anyone to deny you these rights or to ask you to surrender the rights. These restrictions translate to certain responsibilities for you if you distribute copies of the software, or if you modify it. +</p> +<p> +For example, if you distribute copies of such a program, whether gratis or for a fee, you must give the recipients all the rights that you have. You must make sure that they, too, receive or can get the source code. And you must show them these terms so they know their rights. +</p> +<p> +We protect your rights with two steps: (1) copyright the software, and (2) offer you this license which gives you legal permission to copy, distribute and/or modify the software. +</p> +<p> +Also, for each author's protection and ours, we want to make certain that everyone understands that there is no warranty for this free software. If the software is modified by someone else and passed on, we want its recipients to know that what they have is not the original, so that any problems introduced by others will not reflect on the original authors' reputations. +</p> +<p> +Finally, any free program is threatened constantly by software patents. We wish to avoid the danger that redistributors of a free program will individually obtain patent licenses, in effect making the program proprietary. To prevent this, we have made it clear that any patent must be licensed for everyone's free use or not licensed at all. +</p> +<p> +The precise terms and conditions for copying, distribution and modification follow. +</p> +<p> +GNU GENERAL PUBLIC LICENSE +</p> +<p> +<strong>TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION</strong> +</p> +<p> +0. This License applies to any program or other work which contains a notice placed by the copyright holder saying it may be distributed under the terms of this General Public License. The "Program", below, refers to any such program or work, and a "work based on the Program" means either the Program or any derivative work under copyright law: that is to say, a work containing the Program or a portion of it, either verbatim or with modifications and/or translated into another language. (Hereinafter, translation is included without limitation in the term "modification".) Each licensee is addressed as "you". +</p> +<p> +Activities other than copying, distribution and modification are not covered by this License; they are outside its scope. The act of running the Program is not restricted, and the output from the Program is covered only if its contents constitute a work based on the Program (independent of having been made by running the Program). Whether that is true depends on what the Program does. +</p> +<p> +1. You may copy and distribute verbatim copies of the Program's source code as you receive it, in any medium, provided that you conspicuously and appropriately publish on each copy an appropriate copyright notice and disclaimer of warranty; keep intact all the notices that refer to this License and to the absence of any warranty; and give any other recipients of the Program a copy of this License along with the Program. +</p> +<p> +You may charge a fee for the physical act of transferring a copy, and you may at your option offer warranty protection in exchange for a fee. +</p> +<p> +2. You may modify your copy or copies of the Program or any portion of it, thus forming a work based on the Program, and copy and distribute such modifications or work under the terms of Section 1 above, provided that you also meet all of these conditions: +</p> +<dl><dd> +a) You must cause the modified files to carry prominent notices stating that you changed the files and the date of any change. +</dd> +</dl> +<p> + +</p> +<dl><dd> +b) You must cause any work that you distribute or publish, that in whole or in part contains or is derived from the Program or any part thereof, to be licensed as a whole at no charge to all third parties under the terms of this License. +</dd> +</dl> +<p> + +</p> +<dl><dd> +c) If the modified program normally reads commands interactively when run, you must cause it, when started running for such interactive use in the most ordinary way, to print or display an announcement including an appropriate copyright notice and a notice that there is no warranty (or else, saying that you provide a warranty) and that users may redistribute the program under these conditions, and telling the user how to view a copy of this License. (Exception: if the Program itself is interactive but does not normally print such an announcement, your work based on the Program is not required to print an announcement.) +</dd> +</dl> +<p> +These requirements apply to the modified work as a whole. If identifiable sections of that work are not derived from the Program, and can be reasonably considered independent and separate works in themselves, then this License, and its terms, do not apply to those sections when you distribute them as separate works. But when you distribute the same sections as part of a whole which is a work based on the Program, the distribution of the whole must be on the terms of this License, whose permissions for other licensees extend to the entire whole, and thus to each and every part regardless of who wrote it. +</p> +<p> +Thus, it is not the intent of this section to claim rights or contest your rights to work written entirely by you; rather, the intent is to exercise the right to control the distribution of derivative or collective works based on the Program. +</p> +<p> +In addition, mere aggregation of another work not based on the Program with the Program (or with a work based on the Program) on a volume of a storage or distribution medium does not bring the other work under the scope of this License. +</p> +<p> +3. You may copy and distribute the Program (or a work based on it, under Section 2) in object code or executable form under the terms of Sections 1 and 2 above provided that you also do one of the following: +</p> +<dl><dd> +a) Accompany it with the complete corresponding machine-readable source code, which must be distributed under the terms of Sections 1 and 2 above on a medium customarily used for software interchange; or, +</dd> +</dl> +<p> + +</p> +<dl><dd> +b) Accompany it with a written offer, valid for at least three years, to give any third party, for a charge no more than your cost of physically performing source distribution, a complete machine-readable copy of the corresponding source code, to be distributed under the terms of Sections 1 and 2 above on a medium customarily used for software interchange; or, +</dd> +</dl> +<p> + +</p> +<dl><dd> +c) Accompany it with the information you received as to the offer to distribute corresponding source code. (This alternative is allowed only for noncommercial distribution and only if you received the program in object code or executable form with such an offer, in accord with Subsection b above.) +</dd> +</dl> +<p> +The source code for a work means the preferred form of the work for making modifications to it. For an executable work, complete source code means all the source code for all modules it contains, plus any associated interface definition files, plus the scripts used to control compilation and installation of the executable. However, as a special exception, the source code distributed need not include anything that is normally distributed (in either source or binary form) with the major components (compiler, kernel, and so on) of the operating system on which the executable runs, unless that component itself accompanies the executable. +</p> +<p> +If distribution of executable or object code is made by offering access to copy from a designated place, then offering equivalent access to copy the source code from the same place counts as distribution of the source code, even though third parties are not compelled to copy the source along with the object code. +</p> +<p> +4. You may not copy, modify, sublicense, or distribute the Program except as expressly provided under this License. Any attempt otherwise to copy, modify, sublicense or distribute the Program is void, and will automatically terminate your rights under this License. However, parties who have received copies, or rights, from you under this License will not have their licenses terminated so long as such parties remain in full compliance. +</p> +<p> +5. You are not required to accept this License, since you have not signed it. However, nothing else grants you permission to modify or distribute the Program or its derivative works. These actions are prohibited by law if you do not accept this License. Therefore, by modifying or distributing the Program (or any work based on the Program), you indicate your acceptance of this License to do so, and all its terms and conditions for copying, distributing or modifying the Program or works based on it. +</p> +<p> +6. Each time you redistribute the Program (or any work based on the Program), the recipient automatically receives a license from the original licensor to copy, distribute or modify the Program subject to these terms and conditions. You may not impose any further restrictions on the recipients' exercise of the rights granted herein. You are not responsible for enforcing compliance by third parties to this License. +</p> +<p> +7. If, as a consequence of a court judgment or allegation of patent infringement or for any other reason (not limited to patent issues), conditions are imposed on you (whether by court order, agreement or otherwise) that contradict the conditions of this License, they do not excuse you from the conditions of this License. If you cannot distribute so as to satisfy simultaneously your obligations under this License and any other pertinent obligations, then as a consequence you may not distribute the Program at all. For example, if a patent license would not permit royalty-free redistribution of the Program by all those who receive copies directly or indirectly through you, then the only way you could satisfy both it and this License would be to refrain entirely from distribution of the Program. +</p> +<p> +If any portion of this section is held invalid or unenforceable under any particular circumstance, the balance of the section is intended to apply and the section as a whole is intended to apply in other circumstances. +</p> +<p> +It is not the purpose of this section to induce you to infringe any patents or other property right claims or to contest validity of any such claims; this section has the sole purpose of protecting the integrity of the free software distribution system, which is implemented by public license practices. Many people have made generous contributions to the wide range of software distributed through that system in reliance on consistent application of that system; it is up to the author/donor to decide if he or she is willing to distribute software through any other system and a licensee cannot impose that choice. +</p> +<p> +This section is intended to make thoroughly clear what is believed to be a consequence of the rest of this License. +</p> +<p> +8. If the distribution and/or use of the Program is restricted in certain countries either by patents or by copyrighted interfaces, the original copyright holder who places the Program under this License may add an explicit geographical distribution limitation excluding those countries, so that distribution is permitted only in or among countries not thus excluded. In such case, this License incorporates the limitation as if written in the body of this License. +</p> +<p> +9. The Free Software Foundation may publish revised and/or new versions of the General Public License from time to time. Such new versions will be similar in spirit to the present version, but may differ in detail to address new problems or concerns. +</p> +<p> +Each version is given a distinguishing version number. If the Program specifies a version number of this License which applies to it and "any later version", you have the option of following the terms and conditions either of that version or of any later version published by the Free Software Foundation. If the Program does not specify a version number of this License, you may choose any version ever published by the Free Software Foundation. +</p> +<p> +10. If you wish to incorporate parts of the Program into other free programs whose distribution conditions are different, write to the author to ask for permission. For software which is copyrighted by the Free Software Foundation, write to the Free Software Foundation; we sometimes make exceptions for this. Our decision will be guided by the two goals of preserving the free status of all derivatives of our free software and of promoting the sharing and reuse of software generally. +</p> +<p> +NO WARRANTY +</p> +<p> +11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION. +</p> +<p> +12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. +</p> +<p> +<strong>END OF TERMS AND CONDITIONS</strong> +</p> +<p> +<strong>How to Apply These Terms to Your New Programs</strong> +</p> +<p> +If you develop a new program, and you want it to be of the greatest possible use to the public, the best way to achieve this is to make it free software which everyone can redistribute and change under these terms. +</p> +<p> +To do so, attach the following notices to the program. It is safest to attach them to the start of each source file to most effectively convey the exclusion of warranty; and each file should have at least the "copyright" line and a pointer to where the full notice is found. +</p> +<dl><dd> +<one line to give the program's name and a brief idea of what it does.> Copyright (C) <year> <name of author> +</dd> +</dl> +<p> + +</p> +<dl><dd> +This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. +</dd> +</dl> +<p> + +</p> +<dl><dd> +This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. +</dd> +</dl> +<p> + +</p> +<dl><dd> +You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. +</dd> +</dl> +<p> +Also add information on how to contact you by electronic and paper mail. +</p> +<p> +If the program is interactive, make it output a short notice like this when it starts in an interactive mode: +</p> +<dl><dd> +Gnomovision version 69, Copyright (C) year name of author Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'. This is free software, and you are welcome to redistribute it under certain conditions; type `show c' for details. +</dd> +</dl> +<p> +The hypothetical commands `show w' and `show c' should show the appropriate parts of the General Public License. Of course, the commands you use may be called something other than `show w' and `show c'; they could even be mouse-clicks or menu items--whatever suits your program. +</p> +<p> +You should also get your employer (if you work as a programmer) or your school, if any, to sign a "copyright disclaimer" for the program, if necessary. Here is a sample; alter the names: +</p> +<dl><dd> +Yoyodyne, Inc., hereby disclaims all copyright interest in the program `Gnomovision' (which makes passes at compilers) written by James Hacker. +</dd> +</dl> +<p> + +</p> +<dl><dd> +<signature of Ty Coon>, 1 April 1989 +</dd> +</dl> +<p> + +</p> +<dl><dd> +Ty Coon, President of Vice +</dd> +</dl> +<p> +This General Public License does not permit incorporating your program into proprietary programs. If your program is a subroutine library, you may consider it more useful to permit linking proprietary applications with the library. If this is what you want to do, use the GNU Lesser General Public License instead of this License. +</p> +<hr> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title>Contributions</title> +<link rel="previous" href="GNUGPLicense.html"> +<link rel="ToC" href="contents.html"> +<link rel="index" href="IndexPage.html"> +<link rel="next" href="IndexPage.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="Contributions"></a>E.4 <a name="i0"></a>Contributions</h1> +<p> +XTrackCAD incorporates the following software: +</p> +<pre><code>This program uses <b>FreeImage</b>, a free, open source image library supporting all common bitmap formats. +See http://freeimage.sourceforge.net for details +</code></pre> +<p> + +</p> +<pre><code><b>uthash</b>, <b>utlist</b> +Copyright (c) 2005-2015, Troy D. Hanson http://troydhanson.github.com/uthash/ +All rights reserved. +</code></pre> +<p> + +</p> +<pre><code><b>CJson</b> - https://github.com/DaveGamble/cJSON/blob/master/README.md#license +Copyright (c) 2009-2017 Dave Gamble and cJSON contributors +</code></pre> +<p> + +</p> +<pre><code><b>zlib</b> - https://opensource.org/licenses/zlib-license.php +</code></pre> +<p> + +</p> +<pre><code><b>libzip</b> - https://libzip.org/license/ +Copyright (C) 1999-2019 Dieter Baron and Thomas Klausner +</code></pre> +<pre><code>The authors can be contacted at <libzip@nih.at> +</code></pre> +<pre><code>Redistribution and use in source and binary forms, with or without +modification, are permitted provided that the following conditions +are met: +</code></pre> +<pre><code>1. Redistributions of source code must retain the above copyright + notice, this list of conditions and the following disclaimer. +</code></pre> +<pre><code>2. Redistributions in binary form must reproduce the above copyright + notice, this list of conditions and the following disclaimer in + the documentation and/or other materials provided with the + distribution. +</code></pre> +<pre><code>3. The names of the authors may not be used to endorse or promote + products derived from this software without specific prior + written permission. +</code></pre> +<pre><code>THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS +OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED +WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY +DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE +GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS +INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER +IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR +OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN +IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. +</code></pre> +<p> + +</p> +<pre><code><b>minixml</b> - https://github.com/michaelrsweet/mxml/commit/f166ad1977f2f13295689772a5d9e442f73d46f1 +</code></pre> +<pre><code>Copyright (C) 2003-2019 by Michael R Sweet. +The Mini-XML library is licensed under the Apache License Version 2.0 with an +exception to allow linking against GPL2/LGPL2-only software. +</code></pre> + +<hr><address></address></body> +</html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" +"http://www.w3.org/TR/html4/strict.dtd"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=US-ASCII"> +<title></title> +<link rel="previous" href="Contributions.html"> +<link rel="ToC" href="contents.html"> +<link rel="stylesheet" type="text/css" href="xtrkcad_lin.css"></head> +<body> +<h1><a name="Index"></a>Index</h1><p> +Archive: <a href="fileM.html#i3">Section 2.5</a>, <a href="cmdLayout.html#i1">Section 2.10.6</a><br> +AutoSave: <a href="cmdPref.html#i1">Section 2.10.7</a>, <a href="cmdPref.html#i2">Section 2.10.7</a><br> +Bench-work: <a href="cmdDrawStraights.html#i1">Section 2.3.7</a>, <a href="cmdDrawBench.html#i1">Section 2.3.7.3</a>, <a href="cmdDrawBench.html#i2">Section 2.3.7.3</a>, <a href="cmdDrawStraight.html#i0">Section 3.3.3.5</a><br> +Bezier Track: <a href="cmdCurve.html#i9">Section 2.1.2</a><br> +Block: <a href="addM.html#i19">Section 2.1</a>, <a href="cmdBlock.html#i0">Section 2.1.10</a><br> +Block Gaps: <a href="splitBlockGap.html#i0">Section 2.2.17.2.2</a><br> +Bridge: <a href="editM.html#i16">Section 2.4</a><br> +Bridge (Draw or Hide Abutments): <a href="cmdBridge.html#i0">Section 2.4.7</a><br> +Bugs: <a href="bugs.html#i0">Section 1.11.1</a><br> +Car Inventory: <a href="cmdCarinv.html#i0">Section 2.9.1</a><br> +Car Item Dialog: <a href="cmdCarpart.html#i0">Section 2.9.1.1</a><br> +Car Part Dialog: <a href="carpart.html#i0">Section 2.9.1.2</a><br> +Car Prototype Dialog: <a href="carprototype.html#i0">Section 2.9.1.3</a><br> +Center, Curved Track: <a href="cmdCurve.html#i5">Section 2.1.2</a><br> +Change Scale: <a href="changeM.html#i21">Section 2.2</a><br> +Choose Parameter Files: <a href="cmdSearchgui.html#i0">Section 2.5.8</a><br> +Chord, Curved Track: <a href="cmdCurve.html#i7">Section 2.1.2</a><br> +Circle Fixed Radius: <a href="cmdCircleFixedRadius.html#i0">Section 2.1.1.1</a><br> +Circle Fixed Tangent: <a href="cmdCircleTangent.html#i0">Section 2.1.1.2</a><br> +Circle From Center: <a href="cmdCircleCenter.html#i0">Section 2.1.1.3</a><br> +Circle Radius: <a href="cmdCircle.html#i3">Section 2.1.1</a>, <a href="cmdCircleFixedRadius.html#i1">Section 2.1.1.1</a><br> +Circles and Filled Circles: <a href="cmdDrawCircles.html#i0">Section 2.3.1</a><br> +Circle Track: <a href="addM.html#i3">Section 2.1</a>, <a href="cmdCircle.html#i0">Section 2.1.1</a>, <a href="cmdCircle.html#i1">Section 2.1.1</a><br> +Clear Elevations: <a href="changeM.html#i19">Section 2.2</a><br> +Clear Filter: <a href="cmdSearchgui.html#i1">Section 2.5.8</a><br> +Colors Dialog: <a href="cmdRgbcolor.html#i0">Section 2.10.1</a><br> +Command Option Dialog: <a href="cmdCmdopt.html#i0">Section 2.10.2</a><br> +Connect Two Tracks: <a href="changeM.html#i12">Section 2.2</a><br> +Context Sensitive Menus: <a href="mouseBcmd.html#i0">Section 3.4.1</a><br> +contributions: <a href="Contributions.html#i0">Section E.4</a><br> +Control: <a href="addM.html#i25">Section 2.1</a>, <a href="cmdControl.html#i0">Section 2.1.13</a><br> +Control Element: <a href="addM.html#i18">Section 2.1</a><br> +Control Element, Block: <a href="addM.html#i20">Section 2.1</a><br> +Control Element, Control: <a href="addM.html#i26">Section 2.1</a><br> +Control Element, Sensor: <a href="addM.html#i28">Section 2.1</a><br> +Control Element, Signal: <a href="addM.html#i24">Section 2.1</a><br> +Control Element, Switchmotor: <a href="addM.html#i22">Section 2.1</a><br> +Convert: <a href="changeM.html#i22">Section 2.2</a><br> +Copy: <a href="editM.html#i4">Section 2.4</a><br> +copying and distribution: <a href="copydist.html#i0">Section E.2</a><br> +Cornu Easements: <a href="joinCornu.html#i2">Section 2.2.7.4</a>, <a href="chgCornu.html#i0">Section 2.2.8.8</a>, <a href="EasementsCornu.html#i0">Section 2.10.4.1</a><br> +Cornu Track: <a href="cmdCurve.html#i11">Section 2.1.2</a><br> +Cornu Turnouts: <a href="cmdTurnoutNew.html#i1">Section 2.9.9</a><br> +Create Cornu Track: <a href="cmdCornu.html#i0">Section 2.1.2.6</a><br> +Creating a Cornu: <a href="joinCornu.html#i0">Section 2.2.7.4</a><br> +Curved Bezier Track: <a href="cmdBezier.html#i0">Section 2.1.2.5</a><br> +Curved Lines: <a href="cmdDrawCurves.html#i0">Section 2.3.2</a><br> +Curved Track: <a href="cmdCurve.html#i0">Section 2.1.2</a><br> +Curved Track, Center: <a href="cmdCurve.html#i6">Section 2.1.2</a><br> +Curved Track, Chord: <a href="cmdCurve.html#i8">Section 2.1.2</a><br> +Curved Track, End Point: <a href="cmdCurve.html#i2">Section 2.1.2</a><br> +Curved Track From Center: <a href="cmdCurveCenter.html#i0">Section 2.1.2.3</a><br> +Curved Track from Chord: <a href="cmdCurveChord.html#i0">Section 2.1.2.4</a><br> +Curved Track from End Point: <a href="cmdCurveEndPt.html#i0">Section 2.1.2.1</a><br> +Curved track from Tangent: <a href="cmdCurveTangent.html#i0">Section 2.1.2.2</a><br> +Curved Track, Tangent: <a href="cmdCurve.html#i4">Section 2.1.2</a><br> +Curve Track: <a href="addM.html#i2">Section 2.1</a><br> +Custom Management: <a href="cmdCustmgm.html#i0">Section 2.9.2</a><br> +Custom Turntable: <a href="addM.html#i16">Section 2.1</a><br> +Cut: <a href="editM.html#i3">Section 2.4</a><br> +Delete: <a href="editM.html#i6">Section 2.4</a>, <a href="cmdDelete.html#i0">Section 2.4.4</a><br> +Demo Mode: <a href="cmdDemo.html#i0">Section 2.6.1</a><br> +Deselect All: <a href="editM.html#i11">Section 2.4</a><br> +Dialogs: <a href="generaloperation.html#i0">Section 3.2</a><br> +Directories: <a href="dirOverview.html#i0">Section 1.9.1</a>, <a href="installDir.html#i0">Section 1.9.2</a>, <a href="workDir.html#i0">Section 1.9.3</a><br> +Display Dialog: <a href="cmdDisplay.html#i0">Section 2.10.3</a><br> +Document: <a href="cmdFileNote.html#i0">Section 2.3.3.3</a><br> +Draw Benchwork: <a href="cmdDrawBench.html#i0">Section 2.3.7.3</a><br> +Draw Bezier Curve: <a href="cmdDrawBezierCurve.html#i0">Section 2.3.2.5</a><br> +Draw Box: <a href="cmdDrawBox.html#i0">Section 2.3.6.1</a><br> +Draw Circle from Center: <a href="cmdDrawCircleCenter.html#i0">Section 2.3.1.2</a><br> +Draw Circle from Tangent: <a href="cmdDrawCircleTangent.html#i0">Section 2.3.1.1</a><br> +Draw Curve from Center: <a href="cmdDrawCurveCenter.html#i0">Section 2.3.2.3</a><br> +Draw Curve from Chord: <a href="cmdDrawCurveChord.html#i0">Section 2.3.2.4</a><br> +Draw Curve from End Point: <a href="cmdDrawCurveEndPt.html#i0">Section 2.3.2.1</a><br> +Draw Curve from Tangent: <a href="cmdDrawCurveTangent.html#i0">Section 2.3.2.2</a><br> +Draw Dimension Line: <a href="cmdDrawDimLine.html#i0">Section 2.3.7.2</a><br> +Draw Filled Box: <a href="cmdDrawFilledBox.html#i0">Section 2.3.6.2</a><br> +Draw Filled Circle from Center: <a href="cmdDrawFilledCircleCenter.html#i0">Section 2.3.1.4</a><br> +Draw Filled Circle from Tangent: <a href="cmdDrawFilledCircleTangent.html#i0">Section 2.3.1.3</a><br> +Draw Filled Polygon: <a href="cmdDrawFilledPolygon.html#i0">Section 2.3.6.4</a><br> +Draw Objects Origin: <a href="DrawOrigin.html#i0">Section 2.3.8</a><br> +Draw Polygon: <a href="cmdDrawPolygon.html#i0">Section 2.3.6.3</a><br> +Draw PolyLine: <a href="cmdDrawPolyline.html#i0">Section 2.3.6.5</a><br> +Draw Shapes: <a href="cmdDrawShapes.html#i0">Section 2.3.6</a><br> +Draw Straight Line: <a href="cmdDrawLine.html#i0">Section 2.3.7.1</a><br> +Draw Table Edge: <a href="cmdDrawTableEdge.html#i0">Section 2.3.7.4</a><br> +Easements: <a href="cmdEasement.html#i0">Section 2.10.4</a>, <a href="EasementsSectional.html#i0">Section 2.10.4.3</a><br> +Easements with Fixed Sharpness: <a href="EasementsTraditional.html#i0">Section 2.10.4.2</a><br> +Elevation: <a href="changeM.html#i17">Section 2.2</a><br> +End Point, Curved Track: <a href="cmdCurve.html#i1">Section 2.1.2</a><br> +Enhancement Requests: <a href="enhancements.html#i0">Section 1.11.2</a><br> +Enumerate: <a href="cmdEnum.html#i1">Section 2.9.6</a><br> +Export: <a href="cmdExport.html#i0">Section 2.5.1</a><br> +Export to Bitmap: <a href="cmdOutputbitmap.html#i0">Section 2.5.2</a><br> +Export to DXF: <a href="ExportDXF.html#i0">Section 2.5.3</a><br> +Export to SVG: <a href="ExportSVG.html#i0">Section 2.5.4</a><br> +File Types: <a href="fileM.html#i1">Section 2.5</a><br> +Fixed-track: <a href="addM.html#i10">Section 2.1</a>, <a href="cmdNewFixedTrack.html#i0">Section 2.1.8</a>, <a href="generalTerms.html#i1">Section B.2</a><br> +Flex-track: <a href="Flex-track.html#i0">Section 2.7.1</a>, <a href="generalTerms.html#i2">Section B.2</a><br> +Flip: <a href="changeM.html#i5">Section 2.2</a><br> +Font Selection: <a href="fontSelW.html#i0">Section 2.10.5</a><br> +Glossary: <a href="windowTerms.html#i0">Section B.1</a>, <a href="generalTerms.html#i0">Section B.2</a><br> +gnu general public license: <a href="GNUGPLicense.html#i0">Section E.3</a><br> +Grid Dialog: <a href="cmdGrid.html#i0">Section 2.12.2</a><br> +Group Dialog: <a href="cmdGroup.html#i0">Section 2.9.4</a><br> +Hand-laid Turnout: <a href="addM.html#i12">Section 2.1</a><br> +Hand-laid Turnouts: <a href="cmdHandLaidTurnout.html#i0">Section 2.1.3</a><br> +Helix: <a href="addM.html#i15">Section 2.1</a><br> +Helix Track: <a href="cmdHelix.html#i0">Section 2.1.4</a><br> +Import: <a href="cmdImport.html#i0">Section 2.5.5</a><br> +Import as Module: <a href="cmdImportM.html#i0">Section 2.5.6</a><br> +Installation: <a href="MSWinInstall.html#i0">Section 1.5.1</a>, <a href="LinuxInstall.html#i0">Section 1.5.3</a>, <a href="installDir.html#i0">Section 1.9.2</a><br> +Invert Selection: <a href="editM.html#i12">Section 2.4</a><br> +Join Lines: <a href="changeM.html#i9">Section 2.2</a><br> +Join Track: <a href="changeM.html#i10">Section 2.2</a><br> +Layers Dialog: <a href="cmdLayer.html#i0">Section 2.9.5</a><br> +Layout Control Elements Dialog: <a href="cmdContmgm.html#i0">Section 2.9.3</a><br> +Layout Dialog: <a href="cmdLayout.html#i0">Section 2.10.6</a><br> +Layout File: <a href="fileM.html#i2">Section 2.5</a><br> +License: <a href="GNUGPLicense.html#i1">Section E.3</a><br> +Line, Parallel: <a href="addM.html#i9">Section 2.1</a><br> +Loosen Tracks: <a href="changeM.html#i6">Section 2.2</a><br> +Mac Installation: <a href="OSXInstall.html#i1">Section 1.5.2</a><br> +Magnetic Snap: <a href="viewM.html#i2">Section 2.12</a><br> +Medium Tracks: <a href="editM.html#i27">Section 2.4</a><br> +Menus: <a href="addM.html#i0">Section 2.1</a>, <a href="changeM.html#i0">Section 2.2</a>, <a href="cmdDraw.html#i0">Section 2.3</a>, <a href="editM.html#i0">Section 2.4</a>, <a href="fileM.html#i0">Section 2.5</a>, <a href="manageM.html#i0">Section 2.9</a>, <a href="optionM.html#i0">Section 2.10</a>, <a href="viewM.html#i0">Section 2.12</a><br> +Message Types: <a href="messageType.html#i0">Section C.1</a><br> +Modify: <a href="changeM.html#i8">Section 2.2</a><br> +Modifying a Cornu: <a href="joinCornu.html#i1">Section 2.2.7.4</a><br> +Move: <a href="changeM.html#i3">Section 2.2</a><br> +Move Description: <a href="changeM.html#i15">Section 2.2</a><br> +Move To Back: <a href="editM.html#i24">Section 2.4</a>, <a href="cmdAboveBelow.html#i1">Section 2.4.2</a><br> +Move To Current Layer: <a href="editM.html#i7">Section 2.4</a><br> +Move To Front: <a href="editM.html#i23">Section 2.4</a>, <a href="cmdAboveBelow.html#i0">Section 2.4.2</a><br> +Navigation: <a href="aboutmanual.html#i0">Section 1.4</a>, <a href="viewM.html#i3">Section 2.12</a>, <a href="mainW.html#i0">Section 3.1</a>, <a href="enterValue.html#i0">Section 3.2.1</a>, <a href="cmdMap.html#i0">Section 3.2.2</a>, <a href="kbshortcuts.html#i0">Section 3.3</a>, <a href="kbshortcuts.html#i1">Section 3.3</a>, <a href="cmdAcclKeys.html#i0">Section 3.4</a><br> +Note Variants: <a href="cmdNote.html#i0">Section 2.3.3</a><br> +OSX Installation: <a href="OSXInstall.html#i0">Section 1.5.2</a><br> +OSX Run Security: <a href="OSXInstall.html#i2">Section 1.5.2</a><br> +Parallel: <a href="addM.html#i5">Section 2.1</a><br> +Parallel Line: <a href="addM.html#i8">Section 2.1</a><br> +Parallel Lines: <a href="cmdParallelLine.html#i0">Section 2.1.5.2</a><br> +Parallel Track: <a href="addM.html#i6">Section 2.1</a>, <a href="cmdParallelTrack.html#i0">Section 2.1.5.1</a><br> +Parallel Track or Line: <a href="cmdParallel.html#i0">Section 2.1.5</a><br> +Parameter Files: <a href="cmdPrmfile.html#i0">Section 2.5.7</a><br> +Parts List: <a href="cmdEnum.html#i0">Section 2.9.6</a><br> +Paste: <a href="editM.html#i5">Section 2.4</a><br> +Preferences Dialog: <a href="cmdPref.html#i0">Section 2.10.7</a><br> +Price List: <a href="cmdPricelist.html#i0">Section 2.9.7</a><br> +Printer Margin: <a href="cmdPrintMargin.html#i0">Section 2.5.11</a><br> +Printer Setup: <a href="printSetup.html#i0">Section 2.5.10</a><br> +Printing: <a href="cmdPrint.html#i0">Section 2.5.9</a>, <a href="Linux.html#i0">Section 2.5.10.1</a>, <a href="MS-Windows.html#i0">Section 2.5.10.2</a>, <a href="faqsTransfer.html#i0">Section A.1</a><br> +Profile: <a href="changeM.html#i18">Section 2.2</a><br> +Properties: <a href="changeM.html#i1">Section 2.2</a><br> +Protractor: <a href="cmdAngle.html#i0">Section 2.3.5</a><br> +Raise/Lower Elevations: <a href="changeM.html#i16">Section 2.2</a><br> +Recompute Elevations: <a href="changeM.html#i20">Section 2.2</a><br> +Redo: <a href="editM.html#i2">Section 2.4</a>, <a href="cmdUndo.html#i1">Section 2.4.9</a><br> +Removing XTrackCAD: <a href="uninstall.html#i0">Section 1.10</a><br> +Roadbed: <a href="editM.html#i18">Section 2.4</a><br> +Roadbed (Draw or Hide Base): <a href="cmdRoadbed.html#i0">Section 2.4.8</a><br> +Rotate: <a href="changeM.html#i4">Section 2.2</a><br> +Ruler: <a href="cmdRuler.html#i0">Section 2.3.4</a><br> +Run Trains: <a href="cmdTrain.html#i2">Section 2.9.8</a><br> +Sectional Track: <a href="cmdConnect.html#i0">Section 2.2.3</a><br> +Select: <a href="changeM.html#i2">Section 2.2</a><br> +Select All: <a href="editM.html#i8">Section 2.4</a><br> +Select By Index: <a href="editM.html#i10">Section 2.4</a>, <a href="cmdSelectIndex.html#i0">Section 2.4.1</a><br> +Select Current Layer: <a href="editM.html#i9">Section 2.4</a><br> +Select Stranded Track: <a href="editM.html#i13">Section 2.4</a><br> +Sensor: <a href="addM.html#i27">Section 2.1</a>, <a href="cmdSensor.html#i0">Section 2.1.14</a><br> +Shortcut Keys: <a href="addshortcutkeys.html#i0">Section 2.4.3</a>, <a href="kbshortcuts.html#i0">Section 3.3</a>, <a href="kbshortcuts.html#i1">Section 3.3</a>, <a href="kbshortcutHotBar.html#i0">Section 3.3.6</a>, <a href="kbshortcutMainCanvas.html#i0">Section 3.3.8</a>, <a href="cmdAcclKeys.html#i0">Section 3.4</a><br> +Signal: <a href="addM.html#i23">Section 2.1</a>, <a href="cmdSignal.html#i0">Section 2.1.12</a><br> +Simulation: <a href="cmdTrain.html#i1">Section 2.9.8</a><br> +Snap Grid: <a href="viewM.html#i1">Section 2.12</a><br> +Split: <a href="changeM.html#i14">Section 2.2</a><br> +Start the Program: <a href="startSoftware.html#i0">Section 1.6</a><br> +Sticky Dialog: <a href="cmdSticky.html#i0">Section 2.10.8</a><br> +Straight Objects: <a href="cmdDrawStraights.html#i0">Section 2.3.7</a><br> +Straight Track: <a href="addM.html#i1">Section 2.1</a>, <a href="cmdStraight.html#i0">Section 2.1.6</a>, <a href="mouseBcmd.html#i1">Section 3.4.1</a><br> +Structure: <a href="addM.html#i14">Section 2.1</a>, <a href="cmdStructure.html#i0">Section 2.1.7</a><br> +Structures: <a href="hbStructures.html#i0">Section 2.7.2</a><br> +Switchmotor: <a href="addM.html#i21">Section 2.1</a>, <a href="cmdSwitchmotor.html#i0">Section 2.1.11</a><br> +Tangent, Curved Track: <a href="cmdCurve.html#i3">Section 2.1.2</a><br> +Text: <a href="cmdText.html#i0">Section 2.3.9</a><br> +Text Note: <a href="cmdTextNote.html#i0">Section 2.3.3.1</a><br> +Thick Tracks: <a href="editM.html#i28">Section 2.4</a><br> +Thin, Medium and Thick Tracks: <a href="editM.html#i25">Section 2.4</a><br> +Thin Tracks: <a href="editM.html#i26">Section 2.4</a><br> +Ties (Draw or Hide Ties): <a href="cmdTies.html#i0">Section 2.4.6</a><br> +Ties/No Ties: <a href="editM.html#i20">Section 2.4</a><br> +Tool-bar Configuration: <a href="toolbarM.html#i0">Section 2.12.3</a><br> +Track, Bezier: <a href="cmdCurve.html#i10">Section 2.1.2</a><br> +Track, Bridge: <a href="editM.html#i17">Section 2.4</a><br> +Track, Circle: <a href="addM.html#i4">Section 2.1</a>, <a href="cmdCircle.html#i2">Section 2.1.1</a><br> +Track, Connect: <a href="changeM.html#i13">Section 2.2</a><br> +Track, Cornu: <a href="cmdCurve.html#i12">Section 2.1.2</a><br> +Track, Fixed: <a href="addM.html#i11">Section 2.1</a><br> +Track, Join: <a href="changeM.html#i11">Section 2.2</a><br> +Track, Loosen: <a href="changeM.html#i7">Section 2.2</a><br> +Track No Ties: <a href="editM.html#i22">Section 2.4</a><br> +Track, Parallel: <a href="addM.html#i7">Section 2.1</a><br> +Track, Roadbed: <a href="editM.html#i19">Section 2.4</a><br> +Tracks, Medium: <a href="editM.html#i30">Section 2.4</a><br> +Tracks, Thick: <a href="editM.html#i31">Section 2.4</a><br> +Tracks, Thin: <a href="editM.html#i29">Section 2.4</a><br> +Track Ties: <a href="editM.html#i21">Section 2.4</a><br> +Track, Tunnel: <a href="editM.html#i15">Section 2.4</a><br> +Track Width: <a href="editM.html#i32">Section 2.4</a><br> +Train Mode: <a href="cmdTrain.html#i0">Section 2.9.8</a><br> +Tunnel: <a href="editM.html#i14">Section 2.4</a><br> +Tunnel (Hide Tracks): <a href="cmdTunnel.html#i0">Section 2.4.5</a><br> +Turnout Designer: <a href="cmdTurnoutNew.html#i0">Section 2.9.9</a><br> +Turnout, Hand-laid: <a href="addM.html#i13">Section 2.1</a><br> +Turnouts: <a href="hbTurnouts.html#i0">Section 2.7.3</a><br> +Turntable, Custom: <a href="addM.html#i17">Section 2.1</a><br> +Turntables: <a href="cmdTurntable.html#i0">Section 2.1.9</a><br> +Undo: <a href="editM.html#i1">Section 2.4</a>, <a href="cmdUndo.html#i0">Section 2.4.9</a><br> +Ungroup: <a href="cmdUngroup.html#i0">Section 2.9.11</a><br> +Update Turnouts and Structures: <a href="cmdRefreshSpecial.html#i0">Section 2.9.10</a><br> +User Support: <a href="support.html#i0">Section 1.11.3</a><br> +Warranty: <a href="warranty.html#i0">Section E.1</a><br> +Weblink: <a href="cmdLinkNote.html#i0">Section 2.3.3.2</a><br> +Zoom: <a href="cmdZoom.html#i0">Section 2.12.4</a><br> +Zoom/Pan Shortcut Keys: <a href="cmdPan.html#i0">Section 2.2.11</a>, <a href="cmdZoom.html#i1">Section 2.12.4</a></p> +<hr><address></address></body> +</html> |