---------------------------------
- X-Plane 11 HD Mesh Scenery v4 -
---------------------------------
by Andras Fabian (www.alpilotx.net)

You can find all of these informations, updates and other goodies on the corresponding download/info web page on my site:
http://www.alpilotx.net/x-plane-11-hd-mesh-scenery-v4/
 
License
------------
The "X-Plane 11 HD Mesh Scenery v4" is completely free to download and free to use. I call it Donationware because if you like the scenery, you are invited to donate for it (but you are definitely NOT OBLIGED to do so). You are invited to donate for it on my website (www.alpilotx.net)!.
DO NOT REDISTRIBUTE / MODIFY / OR CHANGE (for 3rd party purposes) any parts of "HD Mesh Scenery v4" without asking for permission in advance!
(usually - especially for non-commercial use - I allow almost everything, but I like to know about it!).
 
Features
------------
HD Mesh Scenery v4 can be seen as a vastly improved version of the default scenery shipping with XP11. It is using/referencing the exact same set of artwork files (textures, object, autogens, forests) which ship with XP11, so you do not need other art assets to be installed while HD Mesh Scenery v4 will also benefit from any artwork improvements (autogen, texture) coming with future XP11 versions.

The most important advantages of HD Mesh Scenery v4 are:

- The triangle mesh resolution is far higher than in the default mesh and even a bit above the level of the previous HD Mesh Scenery v3:
    - this give - obviously - better DEM (elevation data) representation (slopes, mountains etc.)
    - BUT this also vastly(!) improves the landclass data representation (which in X-Plane is very closely coupled with the triangle size in the mesh). This is most obvious with forest detail.
- The vector data simplification is less aggressive than in the default mesh (where Laminar needed to do that to limit the overall size of the global scenery). Thus road / railroad bendings are more accurate and the same is true for rivers, shorelines (but where the OSM raw data is bad, this can't help much either)
- HD Mesh Scenery v4 also has the new "high buildings" feature included, which I introduced with Laminar in XP11. This puts all (well, with some filtering of not reasonable stuff from OSM)  buildings > 20m "height" or > 5 "building:levels" as some "high building" object (with a more or less correct height - as defined in OSM) in the scenery ("building:levels" are simply multiplied by 4m to get an approximate height). This usually gives most cities a much better look  (New York is a great example, where in OSM almost all buildings already have a height defined). This same approach also "imports" antennas / masts from OSM (as antenna obstacles)
- OSM data is updated (its "date stamp" is 1st October 2017) . Which makes it newer than current XP11 default mesh data and of course much, much newer than the data in HD Mesh Scenery v3.
- Most of the Landclass data has seen an update (which already happened with my work for the XP11 default scenery ... but HD Mesh Scenery v4 can represent the high res landclass data much better)

    
Warnings / Requirements
------------------------
- The scenery requires at least X-Plane 11.00 !!! IT WILL NOT WORK WITH X-Plane 10.xx!
- Please only download a smaller ZIP file at the beginning! Then test if it works for you and only then continue downloading other tiles! Do not unnecessarily overload the hosting providers! If possible, use the BitTorrent option at flightsim.com!
- You might need a very long time to download all tiles. Single file sizes go up to multiple GBytes! In the map you can see the size of each tile.
- Your X-Plane 11 FPS might become very low (if you already have FPS problems, this will not improve your situation!)
- 16 GBytes of RAM are highly recommended! Although many areas might work with 8 GBytes of RAM too.
- 4-6 GBytes of VRAM (on you graphics card) are recommended, esepcially if you use other add-ons too. But by lowering rendering settings, you might get away with less VRAM too.
- HD Mesh Scenery v4 is OS independent. It runs on Mac / Windows / Linux!
- PLEASE READ AND FOLLOW THE INSTALLATION INSTRUCTIONS CAREFULLY, as most of the problems result from an incorrect installation!

Installation
------------
Please follow these few steps as closely as possible (otherwise you can easily end up with a hosed installation - and might not even notice):

- (only once) Create a Subfolder called zzz_hd_global_scenery4 in your Custom Scenery folder (using the zzz_ prefix should highlight, that this package should load at the "bottom" of your scenery list!)
- (only once) Create a Subfolder called "Earth nav data" in your zzz_hd_global_scenery4 folder. It is very important to name it EXACTLY - without the quotes - "Earth nav data" and don't make any typos (it is case sensitive)!
- (for each ZIP file) Uncompressed the ZIP file(s), put the resulting scenery folders (they should have names like +50-130,+30-120,+40+010 etc.) in the previously created (sub)folder "zzz_hd_global_scenery4/Earth nav data/"!

If you are still not sure, how your folder structure should look, it should resemble something like this (this is an example with only 4 packages and a few files ... you will usually have much more):

Custom Scenery/zzz_hd_global_scenery4/
   /-> Earth nav data
      /-> +40-100
      /-> +40-110
      /-> +40-120
      /-> +40-130
         /-> +40-111.dsf
         /-> +40-112.dsf
         /-> +40-113.dsf
         /-> +40-114.dsf
         /-> ...
      /-> ...

Scenery_packs.ini
-----------------
This part is very IMPORTANT! If you do not do this, you will very likely NOT see any of your other add-ons (airports etc.) in a given region anymore! The reason is, that a "base mesh scenery" (which the HD Mesh Scenery v4 is) forms the base of your landscape and only layers above it will be rendered! Anything below the base mesh layer will not even be loaded.
(You only need to do this once, when you install your first HD Mesh Scenery v4 package ... All other packages are going in the same Custom Scenery folder, so they don't need extra attention)

Here are the most important points:
-  For HD Mesh Scenery to work well with other Scenery Packages, its best to put it at the bottom(!) of scenery_packs.ini! Simply use any text editor coming with you OS
- If you start X-Plane 11 the first time OR deleted(!) the scenery_packs.ini, it will create a new scenery_packs.ini and populate it exactly in the alphabetic order of your current folder names in “Custom Scenery” (in this case, the zzz_ prefix helps).
- If you already have a scenery_packs.ini (you have already run X-Plane 11 at least once), any new folder in “Custom Scenery” will be put automatically on the TOP (beginning) of scenery_packs.ini (which puts your new scenery folder at the highest level)!
- You can (and should) always manually sort / organize the scenery_packs.ini, as X-Plane only rewrites it when you delete it

If you want to learn more about how to best combine different scenery types and how to best use scenery_packs.ini, you might read this useful tutorial over at the Avsim Forum:

    https://www.avsim.com/forums/topic/442579-understanding-scenery-order/

How to know if the installation was correct?
--------------------------------------------
Quite often people have a broken installation and do not see/use HD Mesh Scenery (even though they think so). There is a very easy and straight forward way (other than obvious or less obvious visual cues)  to check, if X-Plane is really loading the HD Mesh Scenery (and thus, your installation was correct).

- After a - hopefully - correct installation and correctly setting up scenery_packs.ini (see above) start X-Plane at a location where you have added HD Mesh Scenery coverage (of course, it makes no sense to check where you do not have it)!
- When X-Plane has loaded up your airport and you see the scenery, close X-Plane again cleanly (this makes sure, that really everything has been written to the Log.txt).
- Now open a file browser, go to the root directory where X-Plane is installed and open the file Log.txt (thats where X-Plane logs everything good or bad).
- Search for text like "zzz_hd_global_scenery4" (or the EXACT name you called the installation folder inside "Custom Scenery").
- If you find multiple lines, which look like "DSF load time: 5940727 for file Custom Scenery/zzz_hd_global_scenery4/Earth nav data/+20+080/+26+087.dsf (1633010 tris)" (of course, exact dsf file name, and numbers will vary depending on the place you loaded up) then everything is OK! X-Plane is indeed loading DSF (Scenery) files from you HD Mesh Scenery installtion.
- If you do NOT find any such line mentioning loading HD Mesh Scenery v4 DSFs (with "DSF load time .... for file Custom Scenery/zzz_hd_global_scenery4/Earth nav data/ ..."), then something went wrong and you should carefully re-read the installation instructions!

Contact
-------
If you need to contact me, you either find me in most of the well known X-Plane related forums (my pseudonym is: alpilotx) or use the e-mail address on my contact page: 
http://www.alpilotx.net/contact/


Have a lot of fun!

Andras Fabian
www.alpilotx.net

