Delen via


Contourweergave

Geselecteerde objecten kunnen visueel worden gemarkeerd door overzichtsweergave toe te voegen via het onderdeel Hiërarchische statusoverschrijven. In dit hoofdstuk wordt uitgelegd hoe globale parameters voor overzichtsweergave worden gewijzigd via de client-API.

Overzichtseigenschappen zijn een globale instelling. Alle objecten die overzichtsweergave gebruiken, gebruiken dezelfde instelling. Het is niet mogelijk om een omtrekkleur per object te gebruiken.

Notitie

Het weergave-effect van het overzicht kan niet worden toegepast op puntwolken.

Parameters voor OutlineSettings

Klasse OutlineSettings bevat de instellingen met betrekking tot globale overzichtseigenschappen. De volgende leden worden weergegeven:

Parameter Type Description
Color Color4Ub De kleur die wordt gebruikt voor het tekenen van de omtrek. Het alfagedeelte wordt genegeerd.
PulseRateHz zwevend De snelheid waarmee de omtrek per seconde osctueert
PulseIntensity zwevend De intensiteit van het contourpulseffect. Moet tussen 0,0 zijn voor geen pulsing en 1,0 voor volledige pulsing. Met intensiteit wordt impliciet de minimale dekking van het overzicht ingesteld als MinOpacity = 1.0 - PulseIntensity.
MaskTexture 2D-patroon Indien opgegeven, wordt de kleur van de omtrek getint door dit patroon. Het patroon wordt genomen in schermruimtecoördinaten en verschillende parameters (MaskScale, MaskScaleToFit, MaskScrollSpeedMaskOffset, MaskRotationCenter, , MaskRotationAngle) MaskRotationSpeedzijn van invloed op het uitrekken, draaien en schuiven van die toewijzing. Deze functie kan worden gebruikt om effecten te bereiken, zoals een kleurovergang of stippellijnen. Zie de tweede voorbeeldafbeelding hieronder.

Een object dat drie keer wordt weergegeven met verschillende overzichtsparameters Het effect van het wijzigen van de color parameter van geel (links) in magenta (midden) en pulseIntensity van 0 tot 0,8 (rechts).

Een object dat twee keer wordt weergegeven met afzonderlijke gebruiksvoorbeelden voor patroonmaskers Het effect van het toepassen van een maskerpatroon op de contouren: Scherm uitgelijnde kleurovergangen (links) of stippellijnen gesimuleerd met behulp van een tegelpatroon met strepen (rechts).

Opmerking

De volgende code toont een voorbeeld voor het instellen van overzichtsparameters via de API:

void SetOutlineParameters(RenderingSession session)
{
    OutlineSettings outlineSettings = session.Connection.OutlineSettings;
    outlineSettings.Color = new Color4Ub(255, 255, 0, 255);
    outlineSettings.PulseRateHz = 2.0f;
    outlineSettings.PulseIntensity = 0.5f;
}
void SetOutlineParameters(ApiHandle<RenderingSession> session)
{
    ApiHandle<OutlineSettings> outlineSettings = session->Connection()->GetOutlineSettings();
    Color4Ub outlineColor;
    outlineColor.channels = { 255, 255, 0, 255 };
    outlineSettings->SetColor(outlineColor);
    outlineSettings->SetPulseRateHz(2.0f);
    outlineSettings->SetPulseIntensity(0.5f);
}

Prestaties

Overzichtsweergave kan een aanzienlijke invloed hebben op de renderingprestaties. Deze impact varieert op basis van de ruimtelijke relatie tussen geselecteerde en niet-geselecteerde objecten voor een bepaald frame.

API-documentatie

Volgende stappen