Marble/MoonMaps: Difference between revisions

    From KDE TechBase
    (Created page with "=Moon Maps for Marble= So you want to add moon maps to Marble. This is great since we want to see lots of maps in Marble where the user can browse through space and time. Ther...")
     
    No edit summary
    Line 3: Line 3:


    You'll find a lot of maps at sites like:
    You'll find a lot of maps at sites like:
    *[http://en.wikipedia.org/| Wikipedia]
    *[http://en.wikipedia.org/ Wikipedia]
    *[http://www.mapaplanet.org/| Mapaplanet]
    *[http://www.mapaplanet.org/ Mapaplanet]
    *[http://astrogeology.usgs.gov/| USGS Astrogeology]
    *[http://astrogeology.usgs.gov/ USGS Astrogeology]




    Before start creating a map, check if its also created at [http://marble.kde.org/maps.php| Marble Maps.]
    Before start creating a map, check if its also created at [http://marble.kde.org/maps.php Marble Maps.]
    Normally these type of maps or rather images, are uploaded in several projections, to create our map, we need a simple cylindrical version. If the map that you want it's not available in a simple cylindrical version, you can follow the steps that are explained at [http://techbase.kde.org/Projects/Marble/HistoricalMaps| Historical Maps]
    Normally these type of maps or rather images, are uploaded in several projections, to create our map, we need a simple cylindrical version. If the map that you want it's not available in a simple cylindrical version, you can follow the steps that are explained at [http://techbase.kde.org/Projects/Marble/HistoricalMaps Historical Maps]




    Line 16: Line 16:
    As an example we start off with this nice map of Iapetus from the Cassini and Voyager missions:
    As an example we start off with this nice map of Iapetus from the Cassini and Voyager missions:


    - [http://www.mapaplanet.org/explorer-bin/explorer.cgi?map=Iapetus&layers=iapetus_cv_bw&west=180&south=-90&east=-180&north=90&center_lat=0&center=0&defaultcenter=on&grid=none&stretch=none&projection=SIMP&r=1&g=1&b=1&advoption=NO&info=YES&resolution=2 |Mapaplanet: Iapetus]
    - [http://www.mapaplanet.org/explorer-bin/explorer.cgi?map=Iapetus&layers=iapetus_cv_bw&west=180&south=-90&east=-180&north=90&center_lat=0&center=0&defaultcenter=on&grid=none&stretch=none&projection=SIMP&r=1&g=1&b=1&advoption=NO&info=YES&resolution=2 Mapaplanet: Iapetus]


    This map has a resolution of 2880 × 5760 which gives us good details, and marble can create the tiles automatically, because it's under 60000x120000. <!--needs to be reviewed-->
    This map has a resolution of 2880 × 5760 which gives us good details, and marble can create the tiles automatically, because it's under 60000x120000. <!--needs to be reviewed-->


    We create a directory "hondius1595" and save our file "1595_Vera_Totius_Hondius.jpg" there.
    We create a directory "Iapetus" that it's the nome of the planet/moon, and inside it, another one "iapetus", that it's the name of the maptheme. We need to change the name of the file downloaded and save it as "iapetus.jpg" at /Iapetus/iapetus.
     
    ===Create a dgml file===
     
    Next you have a template for creating the dgml file. Copy it inside a plain text editor and save it as a .dgml file.
    <pre>&lt;?xml version="1.0" encoding="UTF-8"?&gt;
    &lt;dgml xmlns="http://edu.kde.org/marble/dgml/2.0"&gt;
        &lt;document&gt;
            &lt;head&gt;
                &lt;name&gt;$YourMapName&lt;/name&gt;
                &lt;target&gt;$YourMapTarget&lt;/target&gt;
                &lt;theme&gt;$YourMapTheme&lt;/theme&gt;
                &lt;icon pixmap="$PreviewImage"/&gt;
                &lt;visible&gt;true&lt;/visible&gt;
                &lt;description&gt;&lt;![CDATA[$YourMapDescription]]&gt;&lt;/description&gt;
                &lt;zoom&gt;
                    &lt;discrete&gt; true &lt;/discrete&gt;
                    &lt;minimum&gt; 900 &lt;/minimum&gt;
                    &lt;maximum&gt; 3500 &lt;/maximum&gt;
                &lt;/zoom&gt;
            &lt;/head&gt;
     
            &lt;map bgcolor="#000000"&gt;
                &lt;canvas/&gt;
                &lt;target/&gt;
                &lt;!-- insert layers here --&gt;
            &lt;/map&gt;
     
            &lt;settings&gt;
                &lt;property name="coordinate-grid"&gt;
                    &lt;value&gt;true&lt;/value&gt;
                    &lt;available&gt;true&lt;/available&gt;
                &lt;/property&gt;
                &lt;property name="overviewmap"&gt;
                    &lt;value&gt;true&lt;/value&gt;
                    &lt;available&gt;true&lt;/available&gt;
                &lt;/property&gt;
                &lt;property name="compass"&gt;
                    &lt;value&gt;true&lt;/value&gt;
                    &lt;available&gt;true&lt;/available&gt;
                &lt;/property&gt;
                &lt;property name="scalebar"&gt;
                    &lt;value&gt;true&lt;/value&gt;
                    &lt;available&gt;true&lt;/available&gt;
                &lt;/property&gt;
            &lt;/settings&gt;
     
            &lt;legend&gt;
                &lt;section name="coordinate-grid" checkable="true" connect="coordinate-grid" spacing="12"&gt;
                    &lt;heading&gt;Coordinate Grid&lt;/heading&gt;
                &lt;/section&gt;
            &lt;/legend&gt;
        &lt;/document&gt;
    &lt;/dgml&gt;
    </pre>
     
    Now we need to change some things in this template, like the name of the map, what moon is, etc.
    First, we change the $YourMapTheme by the name of the second directory that you create in this case "iapetus"
    Second, we need to replace $YourMapTarget by

    Revision as of 20:12, 23 January 2013

    Moon Maps for Marble

    So you want to add moon maps to Marble. This is great since we want to see lots of maps in Marble where the user can browse through space and time. There are lots of maps that are under the public domain.

    You'll find a lot of maps at sites like:


    Before start creating a map, check if its also created at Marble Maps. Normally these type of maps or rather images, are uploaded in several projections, to create our map, we need a simple cylindrical version. If the map that you want it's not available in a simple cylindrical version, you can follow the steps that are explained at Historical Maps


    Downloading textures

    As an example we start off with this nice map of Iapetus from the Cassini and Voyager missions:

    - Mapaplanet: Iapetus

    This map has a resolution of 2880 × 5760 which gives us good details, and marble can create the tiles automatically, because it's under 60000x120000.

    We create a directory "Iapetus" that it's the nome of the planet/moon, and inside it, another one "iapetus", that it's the name of the maptheme. We need to change the name of the file downloaded and save it as "iapetus.jpg" at /Iapetus/iapetus.

    Create a dgml file

    Next you have a template for creating the dgml file. Copy it inside a plain text editor and save it as a .dgml file.

    <?xml version="1.0" encoding="UTF-8"?>
    <dgml xmlns="http://edu.kde.org/marble/dgml/2.0">
        <document>
            <head>
                <name>$YourMapName</name>
                <target>$YourMapTarget</target>
                <theme>$YourMapTheme</theme>
                <icon pixmap="$PreviewImage"/>
                <visible>true</visible>
                <description><![CDATA[$YourMapDescription]]></description>
                <zoom>
                    <discrete> true </discrete>
                    <minimum> 900 </minimum>
                    <maximum> 3500 </maximum>
                </zoom>
            </head>
    
            <map bgcolor="#000000">
                <canvas/>
                <target/>
                <!-- insert layers here -->
            </map>
    
            <settings>
                <property name="coordinate-grid">
                    <value>true</value>
                    <available>true</available>
                </property>
                <property name="overviewmap">
                    <value>true</value>
                    <available>true</available>
                </property>
                <property name="compass">
                    <value>true</value>
                    <available>true</available>
                </property>
                <property name="scalebar">
                    <value>true</value>
                    <available>true</available>
                </property>
            </settings>
    
            <legend>
                <section name="coordinate-grid" checkable="true" connect="coordinate-grid" spacing="12">
                    <heading>Coordinate Grid</heading>
                </section>
            </legend>
        </document>
    </dgml>
    

    Now we need to change some things in this template, like the name of the map, what moon is, etc. First, we change the $YourMapTheme by the name of the second directory that you create in this case "iapetus" Second, we need to replace $YourMapTarget by