CifVis Docs

Appearance

Labeled figures ​

maximum-coverage label placement tries to label every requested atom, moving labels into callout lanes outside the structure when local space runs out. Combined with per-element label colours, this produces a fully annotated figure. Typical applications: numbering-scheme figures for papers and CSD deposits.

Reproduce it ​

html
<cifview-widget
    src="structure.cif"
    hydrogen-mode="constant"
    atom-labels="all"
    options='{
        "atomLabels": {
            "placementMode": "maximum-coverage",
            "calloutPlacement": "structure"
        }
    }'>
</cifview-widget>
js
import { CrystalViewer } from 'cifvis';

const viewer = new CrystalViewer(container, {
    hydrogenMode: 'constant',
    atomLabels: {
        show: 'all',
        placementMode: 'maximum-coverage',
        calloutPlacement: 'structure',   // 'viewport' spreads across the full width
    },
});
await viewer.loadCIF(cifText);

// Check what was placed vs. omitted:
console.log(viewer.getAtomLabelLayout());