Multimedia Object

What are multimedia objects?

Multimedia objects (OBJE) are files that contain e.g. images, scanned documents, audio recordings, video clips etc. that relate to some fact within our genealogical data.
A multimedia object may be linked with several entities (person, family, source, …) and vice versa.

Where should we store multimedia objects?

Multimedia files may be stored anywhere in the network. But it is recommended to keep them in a folder structure within the folder of the GEDCOM file. Thus only relative paths are kept, and a transfer of our genealogical data including pictures, document scans or audio files is much easier.

How are multimedia objects documented?

In every entity and almost everywhere in its property structure it could be desired to attach multimedia links, e.g. at a birth or marriage or in a source record.
There are two variants for the property multimedia link (OBJE):

  • as a bare pointer to a multimedia record,
  • as a property containing the descriptions and pointers to the multimedia files itself, called embedded (or inline) multimedia link. In this case no multimedia record is needed.

A multimedia record describes a set of multimedia files and contains pointers to the files, and additionally to sources and to notes.
A multimedia record can be referenced by multimedia links from any other entity that has some kind of connection to the addressed multimedia objects. Thus, it needs to be maintained only once.

Embedded multimedia links cannot be referenced from other entities.

The multimedia link allows to group multiple files together, for example, a sound clip and a photo of an event.

How do we handle multimedia in GenJ?

An entity - person, family, source , or submitter – can be linked with a multimedia link via:

  • menu 'Edit' → 'Add Multimedia',
  • Context Menu on our entity: → 'Add Multimedia',
  • the button 'Add Multimedia'.

This creates the pointer to the multimedia link. In the selector we select either an existing entity or 'New Instance'.
If the entity already existed the editor shows the medium in the gallery of the current entity.
In the other case the empty new record is shown. We can select the media file and name the medium. With a double-click on the reference at the bottom we return to our entity and also see the new medium in the gallery.

A property, e.g. a marriage, we as well can link with a multimedia link (This is called a subordinated multimedia link.) via:

  • context menu of the property → 'Property Marriage' → 'Add Multimedia',
  • the button 'Add Multimedia'. The selector allows us to decide whether we add the pointer to the entity or to a property.

An embedded multimedia link is created in GEDCOM mode via context menu on the entity or the property: → 'Add Property' → 'Multimedia (OBJE)'.

An unrelated multimedia link we create via context menu anywhere: → 'GEDCOM <file>' → 'Add multimedia'. We get a hint, that we create an unrelated record. See also 'Unrelated Entities' in GenJ Usage Recommendations.

Multimedia in the editor

As soon as multimedia files are linked they are shown in the gallery in editor standard mode.
We can magnify the selected picture to the size of the media area and to original size (scroll with the mouse).
Via context menu 'Open' we can open these files by the application predefined for this file type in the operating system.

Properties of an embedded multimedia link we can edit in GEDCOM mode only.

Multimedia in the table

All multimedia records are shown in the Table View via the button 'View Multimedia'.

:-) useful: The list of references shows all the records that reference this note. We can directly jump to them by double-click.

Embedded multimedia can be shown via the button 'Configure view'. For each position of a note in the property structure an own column is necessary.


Proceed to Source

en/manual/obje.txt · Last modified: 2011/01/14 19:49 by kpschubert
Get GenealogyJ at SourceForge.net. Fast, secure and Free Open Source software downloads Recent changes RSS feed Creative Commons License Driven by DokuWiki