Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Minor updates to Overview text #661

Open
wants to merge 6 commits into
base: master
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions content/map/map-view-layout.md
Original file line number Diff line number Diff line change
Expand Up @@ -35,9 +35,9 @@ Here you can find the modules specific to the map view. From top to bottom:
: Tag selected images.

[geotagging](../module-reference/utility-modules/shared/geotagging.md)
: Apply GPX track data to selected images.
: Load, manage and apply GPX track data to selected images.

# bottom panel

[filmstrip](../module-reference/utility-modules/shared/filmstrip.md)
: Drag images from the filmstrip onto the map as described in the map [overview](./overview.md).
: Drag and drop images from the filmstrip onto the map as described in the map [overview](./overview.md).
22 changes: 11 additions & 11 deletions content/map/overview.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,27 +6,27 @@ draft: false
author: "people"
---

The map view allows you to see where your geo-tagged images were taken, and to add location information to non-geo-tagged images.
The map view shows a world map with all geo-tagged images in the current [collection](../lighttable/digital-asset-management/collections.md) pinned to their geo-tagged location.

The map view shows a world map with the images in the current [collection](../lighttable/digital-asset-management/collections.md) pinned to their geo-tagged location (if available). This requires that images are tagged with location information. Some newer cameras, including smartphones, are already equipped with GPS receivers. Other cameras may need additional GPS hardware to do this.
Some newer cameras and smartphones, are already equipped with GPS receivers and can geo-tag each image as the shot is taken. Other cameras may need additional GPS hardware to do this.

Even if your camera doesn't support this feature, there is an alternative method -- darktable can match the Exif date/time in your image(s) to a separate GPX data tracking file created by a GPS tracker, that has recorded your movements. GPS trackers can be purchased as standalone handheld devices or you can install a GPS tracker app on your smartphone. Location tagging with GPS tracking data can be done using the [geotagging](../module-reference/utility-modules/shared/geotagging.md) module, in the lighttable and map views.

# center map view

In the center of the map view you will see a world map.
In addition, you can assign geo coordinates to an image, by activating the [filmstrip](../module-reference/utility-modules/shared/filmstrip.md) on the lower panel (press Ctrl+F)and dragging the image icon from the film-strip to a position on the map. Darktable will record the new location (latitude and longitude ) as part of the image metadata and this data will be included in exported images.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is it "filmstrip" or "film-strip" ?

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

filmstrip


Map data is taken from open map sources on the internet. As such, new map data is only available if you are connected to the internet -- darktable keeps a disk cache of previously loaded map data.
# center map view

You can navigate within the map using your mouse. Left-click and drag to move the map. Use the scroll-wheel to zoom in and out.
In the center panel you will see a world map sourced from an Internet provider. Darktable keeps a disk cache of previously loaded map data so new/updated map data is only available when you are online.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Definitely, a world map is NOT sourced from an Internet provider. An ISP only provides access to the Internet where another organization provides a mapping service.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Victor, Internet provider does not equal ISP, but I take your point that users could be confused so would you agree with this text:

"In the center panel you will see a world map sourced from an Internet based mapping service"

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Victor, Internet provider does not equal ISP

Really??? Can you provide some proof of this statement?

You can choose your provider from:
OpenStreetMap, Maps-For-Free, OpenCycleMap, Public Transport, Google Maps, Google Satellite, Google Hybrid, Virtual Earth, Virtual Earth Satellite, Virtual Earth Hybrid.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I don't think we should list these, they're obvious and subject to change with the underlying library.


On-screen controls and displays are available to help you find your way. A navigation area is located on top left of the map -- use this as an alternative to mouse-dragging and scrolling. The scale of the map is displayed at the bottom-left. At the bottom-right you can see the geographical coordinates for the center of the map.
You can navigate within the map using either your mouse or using on screen controls:

Images that already have geo-location attributes in their metadata are displayed as small icons on the map. Images close to each other are grouped and a count of grouped images is displayed on the bottom-left corner.
Left-click and drag to move the map; use the scroll-wheel to zoom in and out. Navigation buttons are located on top left of the map. The scale of the map is displayed at the bottom-left. At the bottom-right you can see the geographical coordinates for the center of the displayed map.

In order to assign geo coordinates to an image, activate the [filmstrip](../module-reference/utility-modules/shared/filmstrip.md) on the lower panel (press Ctrl+F). You can assign a geo location to an image by dragging the image icon from the film-strip and positioning it on the map -- darktable will record the new location (latitude and longitude ) as part of the image metadata. This data will be included in exported images.
Images that already have geo-location attributes in their metadata are displayed as small icons or thumbnails on the map. Images close to each other are grouped and a count of grouped images is displayed on the bottom-left corner.

In order to remove location data from an image simply drag it from the map and drop it onto the filmstrip.
To remove location data from an image simply drag it from the map and drop it onto the filmstrip.

Images close to each other are grouped under a single image group. You can use the [map settings](../module-reference/utility-modules/map/map-settings.md) module to control the grouping as needed. The number displayed on the bottom left of the thumbnail is the number of images inside the group. A white number means that all images in the group are at exactly the same location, whereas a yellow number means they are not. Use the mouse scroll wheel while hovering over a group of images to scroll through the thumbnails of the images in that group.

Expand Down