컴포넌트 API

@edubeam/plot 0.2.0에 선언된 두 컴포넌트의 프롭과 이벤트입니다. 두 컴포넌트 모두 슬롯은 없습니다. SI 단위인 값은 따로 표시했고, 크기는 CSS 픽셀입니다.

StructurePlot

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

평면 구조물과 그 결과를 그립니다. 가이드: StructurePlot.

프롭

프롭타입기본값설명
solverSolver–@edubeam/fem 솔버. 하중조건을 풀고 나면 결과를 그립니다.
modelPlotModel–또는 modelFromSolver가 만드는 일반 데이터. solver보다 우선합니다.
loadCasenumber0solver.loadCases의 인덱스
revisionnumber0그 자리에서 고친 솔버를 다시 그리려면 값을 바꿉니다
layersreadonly PlotLayer[]members, supports, loads, reactions and one result그릴 것: 'nodes', 'nodeLabels', 'dimensions', 'members', 'supports', 'loads', 'reactions', 'N', 'V', 'M', 'w'
reservereadonly PlotLayer[]layers숨겨져 있는 동안에도 자리를 잡아 둘 레이어
compactbooleanfalse썸네일용 그림: 작은 기호, 부재마다 값은 많아야 두 개
unitsPartial<Units>KN_UNITS표시 단위
numberFormatIntl.NumberFormatEnglish, at most 1 decimal모든 숫자의 형식
colorsPartial<PlotColors>–톤별 색 변경: 테마와 색상
widthnumber640, compact 400상자 크기를 재기 전의 너비(서버에서처럼)
heightnumber–고정 높이. 없으면 높이가 그림을 따릅니다.
maxHeightnumbermax(320, 0.75 × width), compact none자동 높이의 상한
paddingnumber6그림 둘레의 여백
fontSizenumber13, compact 11.5글자 크기
diagramSizenumber48, compact 26다이어그램에서 가장 큰 종거의 길이
deformedSizenumber30, compact 18변형 형상의 최대 변위
diagramScalePartial<Record<ResultLayer, number>>–결과별로 고정한 SI 단위당 px. diagramSize나 deformedSize보다 우선
momentOnTensionSidebooleantrueM을 인장 측에 그림. false이면 압축 측
resultLabelMode'horizontal' | 'axis''horizontal'값을 똑바로 세워 쓸지, 종거 방향으로 돌려 쓸지
reactionLabels'values' | 'names''values'반력을 실제 작용 방향과 크기로 그리거나, 연습 문제용으로 구속된 방향마다 이름(Ax, MA)을 붙여 양의 방향으로 그립니다. 이름에는 해석 결과가 필요 없습니다: 미지수로 그린 반력
reserveLabelModesreadonly ResultLabelMode[]–현재 방식 외에 자리를 잡아 둘 레이블 방식
reserveReactionLabelsreadonly ReactionLabels[]–reactionLabels 외에 자리를 잡아 둘 반력 레이블 방식. 연습 문제가 풀이로 바뀌어도 그림이 움직이지 않습니다
animatebooleantrue레이어를 서서히 나타내고 부재를 그려 나갑니다. prefers-reduced-motion이 설정되어 있으면 언제나 꺼집니다.
hoverbooleanfalse포인터 아래의 값을 읽고, 각 다이어그램의 종거 끝에 표시합니다. 끄면 그림은 포인터 입력을 전혀 받지 않습니다.
titlestringa description of what is shown그림의 접근 가능한 이름

layers가 없을 때 그리는 결과는 보와 라멘이면 M, 트러스면 N, 아무 부재도 힘을 받지 않으면 w입니다(defaultResultLayer).

이벤트

이벤트페이로드발생 시점
readoutReadout | nullhover가 있을 때: 포인터 아래의 부재 위치와 그 결과. 포인터가 벗어나면 null
TypeScript
interface Readout {
  readonly member: string
  readonly x: number // 부재의 시작 절점에서 m
  readonly px: number // 화면 위의 점, px
  readonly py: number
  readonly values: Readonly<Record<'N' | 'V' | 'M' | 'w', SidedValue>> // SI 단위
  readonly u: number // 부재의 국부 x 방향 변위, m
}
interface SidedValue {
  readonly left: number
  readonly right: number // 결과가 연속인 곳에서는 left와 같음
}

DiagramStack

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

곧은 보와 그 아래의 다이어그램을 같은 x축으로 그립니다. 부재는 왼쪽에서 오른쪽으로 그린 하나의 수평선을 이루어야 하며, 그렇지 않으면 예외를 던집니다. 가이드: DiagramStack.

프롭

프롭타입기본값설명
solverSolver–풀린 보
modelPlotModel–또는 modelFromSolver가 만드는 일반 데이터. 이쪽이 우선합니다
loadCasenumber0solver.loadCases의 인덱스
revisionnumber0그 자리에서 고친 솔버를 다시 그리려면 값을 바꿉니다
membersreadonly string[]all members보 축선을 이루는 부재
rowsreadonly StackRow[]['V', 'M', 'w']위에서 아래로 놓을 다이어그램 행. 'N', 'V', 'M', 'w' 중에서
loadRowbooleantrue행 위에 지점, 하중, 반력과 함께 그리는 보
rangesPartial<Record<StackRow, readonly [number, number]>>each row's own행별 값 범위, SI 단위
rowHeightsPartial<Record<StackRow, number>>N 100, V 116, M 128, w 76; below 560 px wide 88, 96, 104, 64maxHeight로 줄이기 전의 행 높이
maxHeightnumber–그림이 들어가도록 행이 최대 60 %까지 줄어듭니다. 글자 크기는 그대로입니다.
unitsPartial<Units>KN_UNITS표시 단위
numberFormatIntl.NumberFormatEnglish, at most 1 decimal모든 숫자의 형식
colorsPartial<PlotColors>–색 변경
widthnumber720상자 크기를 재기 전의 너비. 최소 320을 씁니다
fontSizenumber12.5글자 크기
hoverbooleantrue읽기 커서. 끄면 그림은 포인터 입력을 받지 않습니다.
loadAtnumber–읽는 사람이 드래그할 수 있는 집중하중의 위치(선을 따라 m). v-model:load-at과 함께 사용
loadLabelstringP = … with the load's magnitude드래그할 수 있는 하중 옆에 쓰는 글
loadStepnumber0.05드래그한 위치를 이 간격으로 반올림, m. 화살표 키도 이만큼 이동
titlestringa description of the rows그림의 접근 가능한 이름

이벤트

이벤트페이로드발생 시점
update:loadAtnumber읽는 사람이 하중을 옮겼을 때: 새 위치, m. v-model:load-at이 이 이벤트로 동작합니다.
readoutStackReadout | null커서 위치에서 모든 행의 값. 포인터가 벗어나면 null
TypeScript
interface StackReadout {
  readonly x: number // 보 축선을 따라 m
  readonly values: Partial<Record<'N' | 'V' | 'M' | 'w', { readonly left: number; readonly right: number }>> // SI
}

플러그인

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

app.use(EduBeamPlot) // <StructurePlot>과 <DiagramStack>을 전역으로 등록

플러그인은 선택 사항입니다. 컴포넌트를 이름으로 가져오는 편이 더 가볍고, 플러그인을 쓰지 않는 빌드에서는 번들러가 플러그인을 빼 버립니다.

타입

컴포넌트를 타입이 있는 래퍼로 감쌀 수 있도록, 패키지는 프롭과 이벤트의 타입을 내보냅니다.

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

const figure: StructurePlotProps = { layers: ['members', 'supports', 'M'] satisfies PlotLayer[], compact: true }
타입내용
StructurePlotProps, StructurePlotEmitsStructurePlot의 프롭과 이벤트
DiagramStackProps, DiagramStackEmitsDiagramStack의 프롭과 이벤트
Readout, ReadoutQuantity, SidedValue, StackReadout이벤트 페이로드
PlotLayer, ResultLayer, ResultLabelMode, ReactionLabels, StackRow레이어, 결과, 레이블 방식, 반력 레이블, 행의 이름
Units, Unit, UnitKind표시 단위: 종류마다 { symbol, scale }
PlotColors톤별 색
PlotModel일반 데이터 모델: 그림 모델

나머지 내보내기, 즉 SVG 파일을 쓰는 structureSvg와 그림을 그리는 바탕이 되는 함수 등은 함수에 있습니다.