Graphics.Release241 - lordmundi/wikidoctest GitHub Wiki

EDGE v2.4.1 Release Notes

« Getting Help and Support | EDGE User’s Guide | Hardware and Software requirements »

On this page… (hide)

  1. 1. Patches
  2. 2. Hotfixes
  3. 3. Upgrading (please read)
  4. 4. Summary of Changes
    1. 4.1 Linux Compatibility Improved
    2. 4.2 New cone-atron features
    3. 4.3 DCOMM on Windows
    4. 4.4 HDF5 Support Removed
    5. 4.5 Web Commanding Server Upgraded
    6. 4.6 Building in src.dist area fixed
  5. 5. Installation
    1. 5.1 Linux and Mac
    2. 5.2 Windows
    3. 5.3 To integrate into your sim:
  6. 6. Fixes and Enhancements
  7. 7. Known Issues

NOTE: These are the release notes for EDGE version 2.4.1. You can find the release notes for other versions here.

1.  Patches

No patches exist for this version yet.

2.  Hotfixes

There is a hotfix available for users running into an issue with the WCS JPEG and MJPEG not working. It replaces the doug executable file in bin_Linux_x86_64 directory. Only apply this hotfix if you are running into this issue. If you want to easily revert without reinstalling EDGE v2.4.1, backup the doug executable file first. Go to this page to download the hotfix.

3.  Upgrading (please read)

EDGE v2.4.1 is basically a bug-fix release for EDGE v2.4. If you are running EDGE v2.4, you are encouraged to upgrade to EDGE v2.4.1. Some of the items below were also true for EDGE v2.4, but are included here as some users will be upgrading directly from v2.3 to v2.4.1.

While EDGE v2.4.1 is considered a fairly significant release in terms of new features and compatibility issues, most projects should be able to use their 2.3 userdata directories without much interruption. Follow the install instructions in this document and use the "USERDATA" environment variable to point to your userdata directory before starting EDGE (exactly as was done in previous versions). For windows users, the USERDATA directory is usually pointed to in the .bat file used to startup EDGE.

  • EDGE is now 64 bit only

    • While the transition to 64 bit has been slow, now that we are on the train, we don't have enough resources to support both 32 bit and 64 bit builds. The good news is very few (if anyone) is still running 32 bit machines or operating systems any more so the impact of this should be low, but it should making installing dependencies much easier.

  • Base cache updates require deleting USERDATA update caches

    • With the base model cache being updated, the update cache files that user's will have in their $USERDATA/cache folders will not be compatible with EDGE v2.4.1. As you bring over your existing USERDATA to EDGE v2.4.1, be sure and delete this update cache file to allow it to be rebuilt the next time you gracefully exit EDGE. If you don't do this, symptoms will include odd geometry with odd colors or crazy lighting. Delete your $USERDATA/cache/user_cache.update files if upgrading to EDGE v2.4.1! Keep in mind, to rebuild your cache file, all of the model files referenced in the scene requires that those model files be present and readable. Future cache files should be written with a version in them to avoid conflicts.

  • The latest ISS model requires more resources

    • The ISS model in EDGE has been updated to the latest configuration which includes more modules and tons more cables and things like that. All of that adds up to more polygons and a bit more resource requirements on EDGE. This would only apply to scenes that load the ISS model.

  • The CCTV plugin has been removed from loading by default.

    • If you were relying on the CCTV plugin (for example to enforce a 4:3 aspect ratio) and not specifically adding it into your display context, you will need to make sure to add it into your display context in the plugins block. It is still there commented out in cev.cfg and blank.cfg so you can use that as a guide.

4.  Summary of Changes

We are excited to release EDGE v2.4.1 (codenamed "vaccaro"). If you are upgrading from EDGE v2.3, see the release notes for EDGE v2.4 for the large list of changes and enhancements. The changes list below are just those between EDGE v2.4 → EDGE v2.4.1. These changes are mainly bug fixes. See the full list in the "Fixes and Enhancements" below. Some of the most notable changes are:

4.1  Linux Compatibility Improved

The changes in v2.4 brought some instability with the linux version of EDGE, with some people having immediate seg-faults when opening EDGE. That should be fixed now.


New coneatron plugin to dynamically draw multiple cones

4.2  New cone-atron features

The cone-atron plugin and GUI has been updated to let you draw multiple cones in the scene, adjust their position, and even save and load a list of cones.

4.3  DCOMM on Windows

The capability to run DCOMM on Windows should now be restored

4.4  HDF5 Support Removed

With so few customers using HDF5 and the huge amount of files required for HDF5 support, we have decided to remove it. We doubt anyone will notice.

4.5  Web Commanding Server Upgraded

The versions of Jquery and Jquery Mobile running in the WCS mobile page has been upgraded to the latest. We hope this will improve browser compatibility and fix some existing bugs. Internet Explorer support is still limited however.

4.6  Building in src.dist area fixed

Users trying to compile in src.dist found that it was not working in v2.4. This should be fixed in v2.4.1.

5.  Installation

To install:

5.1  Linux and Mac

  1. Unzip the "EDGE_v2.4.1.zip" file.
  2. Change into the EDGE_v2.4.1 directory and run "./run_graphics"
  3. Optionally, run "./run_benchmarks" to get a performance assessment and mail in the results

That's it. As mentioned above, Linux and Mac users can also type "./run_benchmarks" to get a performance assessment of your machine. Email in your benchmark results to help us measure the effects of different drivers, kernel versions, etc., or just to brag about your fancy new hardware.

NOTE: Obviously the support libraries that are installed can vary widely from machine to machine. In general, here is a list for Redhat based systems, Ubuntu systems and Mac

For Redhat systems:

  • gawk
  • glibc
  • cairo
  • freetype
  • mesa-libGL
  • mesa-libGLU
  • libXft
  • libXmu
  • libXScrnSaver
  • libavahi-client
  • libcairo
  • For development:
    • nasm
    • avahi-devel
    • cairo-devel
    • freetype-devel
    • gdal
    • gdal-devel
    • mesa-libGL-devel
    • mesa-libGLU-devel
    • libXft-devel
    • libXmu-devel
    • libXScrnSaver-devel

For Ubuntu systems:

  • tcsh
  • libavahi-client3
  • libcairo2
  • libfreetype6
  • libgdal1i
  • libgl1-mesa-glx
  • libglu1-mesa
  • libxft2
  • libxmu6
  • libxss1
  • libxm4
  • libavahi-compat-libdnssd1
  • For development:
    • nasm
    • libavahi-client-dev
    • libcairo2-dev
    • libfreetype6-dev
    • libgdal-dev
    • libgl1-mesa-dev
    • libglu1-mesa-dev
    • libxft-dev
    • libxmu-dev
    • libxss-dev

For development on the Mac through brew:

  • cairo
  • freetype
  • gdal
  • nasm

If EDGE gives you an error about a missing library, you can find what package provides them using yum commands such as "yum whatprovides libXss.so.1" and installing the 32 bit version.

5.2  Windows

Eventually we want to have a nice installer for Windows. For now, do the following:

  1. Unzip the "EDGE_v2.4.1.zip" file.
  2. Double click "run_graphics.bat" to start EDGE.

5.3  To integrate into your sim:

  • For simple desktop integration with a TRICK simulation, try using the simdata plugin found under the "Options" menu. You can read more about this on the Graphics.DspSimdataNew page. This supports both live sims and post-sim visualization of recorded data.
  • If you want to integrate a Trick simulation, or any other external program using the DCOMM library, see the DCOMM Light Client page.

6.  Fixes and Enhancements

  • 00606 - DCOMM on Windows no longer working
  • 00607 - EDGE seg faults on some linux systems
  • 00608 - MJPEG video streaming from WCS not working on linux
  • 00610 - disable HDF5 support
  • 00611 - make DCOMM connection info print even in quiet mode
  • 00612 - tkcon command console up arrow for history no longer works
  • 00613 - tkcon command console has error on mouse over of err msgs
  • 00615 - Add option for WCS MJPEG to use native window resolution
  • 00616 - weird problems with WCS from browser
  • 00617 - dsp_jpeggrab crashes during startup on the Mac
  • 00618 - upgrade coneatron to dynamically draw and configure multiple cones
  • 00619 - make font sizes scalable
  • 00620 - warning for indirect rendering no longer working
  • 00621 - POST to dandelion web server in WCS not working
  • 00622 - Pull in newest version of PixelStream plugin
  • 00623 - Toggling ATV on and off doesn't seem to do anything
  • 00624 - Tcl/Tk headers missing
  • 00625 - dsp_drawstar warning printout should really be a status print
  • 00626 - default_stars_ files missing from src.dist area

7.  Known Issues

  • 00074 - problems with the -timing command line option
  • 00086 - possible trackcam bug
  • 00100 - script plugin doesn't handle toggles with flags other than HIDE flags
  • 00102 - ztile boundaries show up as lines in planet2 textures
  • 00103 - weird planet2 shading issues
  • 00114 - comm connection error message can cause seg fault
  • 00121 - DSF_GetMapData() may be returning grey when it shouldn't
  • 00173 - Fix DCF_GetRelPosAtt for double precision
  • 00219 - one canvas per viewport when using associate_canvas helper function
  • 00349 - Record plugin cannot handle command arguments with spaces
  • 00350 - figure out why anti-aliasing looks poor on newer nvidia drivers
  • 00351 - dsp_simdata plugin hangs when attempting to unload it on windows
  • 00366 - BASE_ISS state has typos for JimboCam and JIMBO nodes
  • 00387 - CP_7 camera model doesn't rotate with pan/tilt
  • 00403 - poster2 images don't work well with ambient occlusion and blooming
  • 00414 - Simdata stuck while initiating connection
  • 00415 - dsp_hslloader does not error gracefully on unsupported str files
  • 00420 - dcomm library on Mac gives warning
  • 00427 - ac3d loader may be loading some texture coordinates incorrectly
  • 00433 - Sometimes -ztile produces artifacts at or near the boundry between slices
  • 00439 - switch to dynamic allocation for routines that process config file strings
  • 00487 - WCS mobile pages not updating correctly in Internet Explorer
  • 00493 - trackcam causing flickering problems when recording frame images for a movie file
  • 00497 - autocollapse command line option broken
  • 00512 - Simdata dialogue window interferes with image capture
  • 00513 - Jittery Camera Tracking with Simdata Image Capture
  • 00545 - redefining STARS_CONFIG_FILE does not remove drawstar plugin
  • 00552 - lod should hide nodes that are below minimum size or above max distance
  • 00578 - time based lod animation doesn't work on windows
  • 00592 - doug callbacks on nodes seem to be getting called twice
  • 00598 - transparent models not showing correctly on Macs with AMD graphics
  • 00603 - Ugly underlines for menu accelerators on Ubuntu 16.04
  • 00627 - dsp_drawcanvas has error if all views are disabled
  • 00629 - coneatron doesn't work if sourced at runtime
  • 00630 - Right click popup does not work in Windows.
  • 00631 - EDGE complains about not being able to load libbonjour1.1
  • 00632 - Expose jpeglib.h
  • 00633 - WCS JPEG and MJPEG broken on Ubuntu 16.04
  • 00634 - dsp_acloader fails to load texture when texture ID is zero
  • 00636 - PixelStream does not compile with Xcode 9
  • 00637 - EDGE does not start in macOS 10.13 (High Sierra)
  • 00638 - API files #including other files in a subdirectory must use OS-specific path separators
  • 00639 - .so and .dll extensions not automatically transformed in API files
  • 00640 - planet2 doesn't produce elevation consistently and need API to extract vertex patch
  • 00641 - Viewport Sharing of Brightness
  • 00642 - WCS camera page fails when name has unexpected characters
  • 00643 - WCS peer page error when there are no peers
  • 00644 - zeroconf service names are invalid
  • 00646 - Mouse focus on Windows is unreliable
  • 00647 - load argument appears to be getting merged instead of overwritten
  • 00648 - Lens name can't start with a number
  • 00654 - right click popup not working in Windows even with workaround
  • 00655 - zeroconf discovery breaks when LD_LIBRARY_PATH has multiple paths
  • 00656 - specifying a model filename beyond 80 characters can cause DOUG to crash
  • 00659 - reduce possibility of reverse DNS lookups when streaming over MJPEG
  • 00660 - segfault when loading cache file

« Getting Help and Support | EDGE User’s Guide | Hardware and Software requirements »