API komponent

Props a události obou komponent, jak jsou deklarované v @edubeam/plot 0.2.0. Žádná z nich nemá sloty. Hodnoty v jednotkách SI jsou takto označené; velikosti jsou v pixelech CSS.

StructurePlot

TypeScript
import { StructurePlot } from '@edubeam/plot'

Vykreslí rovinnou konstrukci a její výsledky. Návod: StructurePlot.

Props

PropTypVýchozíPopis
solverSolver–Řešič @edubeam/fem. Výsledky se vykreslí, jakmile je jeho zatěžovací stav spočtený.
modelPlotModel–Nebo prostá data, která vytvoří modelFromSolver. Má přednost před solver.
loadCasenumber0Index do solver.loadCases
revisionnumber0Změňte ji, chcete-li překreslit řešič změněný na místě
layersreadonly PlotLayer[]prvky, podpory, zatížení, reakce a jeden výsledekCo vykreslit: 'nodes', 'nodeLabels', 'dimensions', 'members', 'supports', 'loads', 'reactions', 'N', 'V', 'M', 'w'
reservereadonly PlotLayer[]layersVrstvy, pro které se nechává místo, i když jsou skryté
compactbooleanfalseKresba pro náhledy: menší značky, nejvýše dvě hodnoty na prvek
unitsPartial<Units>KN_UNITSZobrazované jednotky
numberFormatIntl.NumberFormatanglický formát, nejvýše 1 desetinné místoFormátuje všechna čísla
colorsPartial<PlotColors>–Přepsání barev podle tónu: Motivy a barvy
widthnumber640, compact 400Šířka, dokud není kontejner změřen, například na serveru
heightnumber–Pevná výška. Bez ní se výška řídí výkresem.
maxHeightnumbermax(320, 0.75 × width), compact žádnáHorní mez automatické výšky
paddingnumber6Okraj kolem výkresu
fontSizenumber13, compact 11.5Velikost textu
diagramSizenumber48, compact 26Délka největší pořadnice průběhu
deformedSizenumber30, compact 18Největší posunutí na deformovaném tvaru
diagramScalePartial<Record<ResultLayer, number>>–Pevný počet px na jednotku SI pro výsledek; přepíše diagramSize nebo deformedSize
momentOnTensionSidebooleantrueM na tažené straně; false pro tlačenou stranu
resultLabelMode'horizontal' | 'axis''horizontal'Hodnoty psané vodorovně, nebo natočené podél pořadnice
reactionLabels'values' | 'names''values'Reakce tak, jak působí, s velikostí; nebo pro zadání příkladu každý podepřený směr pojmenovaný (Ax, MA) a nakreslený v kladném smyslu. Jména nepotřebují výsledky: Reakce jako neznámé
reserveLabelModesreadonly ResultLabelMode[]–Režimy popisků, pro které se kromě aktuálního nechává místo
reserveReactionLabelsreadonly ReactionLabels[]–Styly popisků reakcí, pro které se kromě reactionLabels nechává místo, aby se výkres nepohnul, když se zadání příkladu změní v řešení
animatebooleantruePlynulé objevování vrstev a postupné vykreslování prvků. Při prefers-reduced-motion vždy vypnuté.
hoverbooleanfalseOdečet hodnot pod ukazatelem, vyznačených na konci pořadnice každého průběhu. Když je vypnutý, obrázek na ukazatel vůbec nereaguje.
titlestringpopis toho, co obrázek ukazujePřístupný název obrázku. Výchozí popis je anglický („Structure with its …“); web nebo aplikace ho mohou nahradit přes PLOT_TEXTS z @edubeam/plot.

Bez layers je výsledkem M pro nosníky a rámy, N pro příhradovou konstrukci a w, když žádný prvek nepřenáší sílu (defaultResultLayer).

Události

UdálostDataKdy
readoutReadout | nullS hover: bod prvku pod ukazatelem a jeho výsledky; null, když ukazatel odjede
TypeScript
interface Readout {
  readonly member: string
  readonly x: number // m od počátečního uzlu prvku
  readonly px: number // bod na obrazovce, px
  readonly py: number
  readonly values: Readonly<Record<'N' | 'V' | 'M' | 'w', SidedValue>> // jednotky SI
  readonly u: number // posunutí ve směru lokální osy x prvku, m
}
interface SidedValue {
  readonly left: number
  readonly right: number // rovné left tam, kde je výsledek spojitý
}

DiagramStack

TypeScript
import { DiagramStack } from '@edubeam/plot'

Vykreslí přímý nosník nad jeho průběhy na společné ose x. Prvky musí tvořit jednu vodorovnou přímku zadanou zleva doprava; cokoli jiného vyhodí chybu. Návod: DiagramStack.

Props

PropTypVýchozíPopis
solverSolver–Spočtený nosník
modelPlotModel–Nebo prostá data z modelFromSolver; mají přednost
loadCasenumber0Index do solver.loadCases
revisionnumber0Změňte ji, chcete-li překreslit řešič změněný na místě
membersreadonly string[]všechny prvkyPrvky nosníku
rowsreadonly StackRow[]['V', 'M', 'w']Řádky průběhů shora dolů, z 'N', 'V', 'M', 'w'
loadRowbooleantrueNosník s podporami, zatížením a reakcemi nad řádky
rangesPartial<Record<StackRow, readonly [number, number]>>vlastní rozsah každého řádkuRozsah hodnot pro každý řádek, jednotky SI
rowHeightsPartial<Record<StackRow, number>>N 100, V 116, M 128, w 76; při šířce pod 560 px 88, 96, 104, 64Výšky řádků předtím, než je zmenší maxHeight
maxHeightnumber–Řádky se zmenší, nejvýše na 60 %, aby se obrázek vešel. Text si velikost drží.
unitsPartial<Units>KN_UNITSZobrazované jednotky
numberFormatIntl.NumberFormatanglický formát, nejvýše 1 desetinné místoFormátuje všechna čísla
colorsPartial<PlotColors>–Přepsání barev
widthnumber720Šířka, dokud není kontejner změřen; použije se nejméně 320
fontSizenumber12.5Velikost textu
hoverbooleantrueKurzor pro odečítání. Když je vypnutý, obrázek na ukazatel nereaguje.
loadAtnumber–Poloha (m podél přímky) osamělé síly, kterou může čtenář posouvat; používá se s v-model:load-at
loadLabelstringP = … s velikostí sílyText vedle posuvné síly
loadStepnumber0.05Krok, na který se tažení zaokrouhluje, m; o tento krok posouvají sílu šipky
titlestringpopis řádkůPřístupný název obrázku

Události

UdálostDataKdy
update:loadAtnumberČtenář posunul sílu: její nová poloha, m. Pohání v-model:load-at.
readoutStackReadout | nullHodnoty kurzoru ve všech řádcích; null, když ukazatel odjede
TypeScript
interface StackReadout {
  readonly x: number // m podél nosníku
  readonly values: Partial<Record<'N' | 'V' | 'M' | 'w', { readonly left: number; readonly right: number }>> // SI
}

Plugin

TypeScript
import { EduBeamPlot } from '@edubeam/plot'

app.use(EduBeamPlot) // zaregistruje <StructurePlot> a <DiagramStack> globálně

Plugin je nepovinný: import komponent podle jména je úspornější a bundler plugin z buildu, který ho nepoužívá, vypustí.

Typy

Pro typované obaly komponent exportuje balíček jejich props a události:

TypeScript
import type { PlotLayer, StructurePlotProps } from '@edubeam/plot'

const figure: StructurePlotProps = { layers: ['members', 'supports', 'M'] satisfies PlotLayer[], compact: true }
TypPopis
StructurePlotProps, StructurePlotEmitsProps a události StructurePlot
DiagramStackProps, DiagramStackEmitsProps a události DiagramStack
Readout, ReadoutQuantity, SidedValue, StackReadoutData událostí
PlotLayer, ResultLayer, ResultLabelMode, ReactionLabels, StackRowNázvy vrstev, výsledků, režimů popisků, popisků reakcí a řádků
Units, Unit, UnitKindZobrazované jednotky: { symbol, scale } pro každý druh
PlotColorsBarvy podle tónu
PlotModelModel jako prostá data: Model pro vykreslení

Ostatní exporty, mezi nimi structureSvg pro soubory SVG a funkce, na kterých stojí kreslení, najdete na stránce Funkce.