[G1-Sync] Manual knowledge update
This commit is contained in:
Antigravity Agent
@@ -2,96 +2,170 @@
|
||||
id: wiki-2026-0508-에일리어싱-aliasing
|
||||
title: 에일리어싱 (Aliasing)
|
||||
category: 10_Wiki/Topics
|
||||
status: needs_review
|
||||
status: verified
|
||||
canonical_id: self
|
||||
aliases: [P-Reinforce-AUTO-E5B908]
|
||||
aliases: [Aliasing, 계단현상, Jaggies]
|
||||
duplicate_of: none
|
||||
source_trust_level: A
|
||||
confidence_score: 0.9
|
||||
tags: [auto-reinforced]
|
||||
verification_status: applied
|
||||
tags: [graphics, rendering, frontend, antialiasing]
|
||||
raw_sources: []
|
||||
last_reinforced: 2026-04-20
|
||||
github_commit: "[P-Reinforce] Continuous Worker - 에일리어싱 (Aliasing)"
|
||||
inferred_by: Claude Opus 4.7 (auto-normalize 2026-05-08)
|
||||
last_reinforced: 2026-05-10
|
||||
github_commit: pending
|
||||
tech_stack:
|
||||
language: unspecified
|
||||
framework: unspecified
|
||||
language: CSS/JS
|
||||
framework: Canvas/WebGL
|
||||
---
|
||||
|
||||
# [[에일리어싱 (Aliasing)|에일리어싱 (Aliasing]]
|
||||
# 에일리어싱 (Aliasing)
|
||||
|
||||
## 📌 한 줄 통찰 (The Karpathy Summary)
|
||||
> 에일리어싱(Aliasing)은 프로그래밍에서 기존 데이터 타입에 새로운 이름을 부여하거나(타입 에일리어싱), 동일한 데이터를 여러 참조 변수가 가리키게 되는 현상(참조 에일리어싱)을 의미합니다 [1, 2]. TypeScript에서 타입 에일리어싱은 기존 타입과 상호 호환되는 서술적인 이름표 역할을 하며, 참조 에일리어싱은 `[[readonly|readonly]]` 데이터가 가변(mutable) 참조로 전달될 때 의도치 않은 데이터 변형(Mutation)을 일으키는 주요 원인이 되기도 합니다 [1-3].
|
||||
## 매 한 줄
|
||||
> **"매 sampling rate 가 signal frequency 의 절반 미만일 때 발생하는 distortion"**. Nyquist theorem 위반 의 결과로, frontend 에서 매 jagged edges, moiré patterns, shimmer 형태로 나타남. 매 antialiasing (AA) 기법으로 완화.
|
||||
|
||||
## 📖 구조화된 지식 (Synthesized Content)
|
||||
- **타입 에일리어싱 ([[Type Alias|Type Alias]]ing):**
|
||||
TypeScript에서 `type` 키워드를 사용하여 기존 타입에 새로운 이름을 부여하는 것을 타입 에일리어스라고 부릅니다 [4]. 예를 들어 `type Percentage = number`와 같이 선언할 수 있으나, 이는 단순히 기존 타입에 새로운 이름을 부여하는 서술적인(descriptive) 역할만 할 뿐, 기능적으로 완전히 독립된 새로운 타입을 생성하는 것은 아닙니다(기존 타입과 상호 교환 가능) [1]. 주로 원시 타입(primitives), 유니언(unions), 튜플(tuples) 등 인터페이스로 표현하기 힘든 복잡한 타입 구성을 명명할 때 사용됩니다 [4, 5].
|
||||
## 매 핵심
|
||||
|
||||
- **데이터 참조 에일리어싱과 `readonly`의 함정:**
|
||||
TypeScript에서 `readonly` 수식어를 사용할 때 개발자들이 가장 자주 겪는 함정은 에일리어싱(Aliasing)을 통한 데이터 변형입니다 [2]. `readonly`는 오직 해당 `readonly` 참조를 통한 직접적인 접근 및 수정만을 방지합니다 [6].
|
||||
### 매 정의
|
||||
- **Spatial aliasing**: 매 jagged edges (계단 현상) — pixel grid 가 매 diagonal/curved line 의 표현 부족.
|
||||
- **Temporal aliasing**: 매 frame rate 부족 의 결과 — wagon-wheel effect, stutter.
|
||||
- **Texture aliasing**: 매 minification 시 매 moiré pattern.
|
||||
|
||||
- **타입 호환성으로 인한 변형 위험:**
|
||||
만약 `readonly`로 선언된 배열이나 객체를 가변(mutable) 매개변수를 기대하는 함수에 전달할 경우, TypeScript는 타입 호환성(type compatibility)의 이유로 이를 허용하게 됩니다 [2]. 이렇게 에일리어싱이 발생하면 해당 함수 내부에서 가변 참조를 통해 원본 "readonly" 데이터를 수정할 수 있는 취약점이 발생합니다 [2, 3]. 이를 방지하기 위해서는 함수 시그니처를 신중하게 설계하여 `readonly` 매개변수를 받도록 강제하거나, 데이터를 복사하여 전달해야 합니다 [3].
|
||||
### 매 원인
|
||||
- **Discrete sampling**: 매 continuous signal 을 discrete pixel 로 sampling.
|
||||
- **Sub-pixel detail**: 매 single pixel 보다 작은 detail 의 미손실 표현 불가.
|
||||
- **Nyquist criterion**: 매 sampling_rate ≥ 2 × max_frequency 충족 X.
|
||||
|
||||
## ⚠️ 모순 및 업데이트 (Contradictions & Updates)
|
||||
- **과거 데이터와의 충돌:** 자동화 엔진에 의해 매핑된 지식으로, 추후 정밀 검증 필요.
|
||||
- **정책 변화:** Programming & Language 분야의 자동 자산화 수행.
|
||||
### 매 응용 (frontend)
|
||||
1. **Canvas/WebGL rendering**: 매 line, polygon, font 의 smooth rendering.
|
||||
2. **CSS transforms**: 매 rotated/scaled element 의 edge.
|
||||
3. **SVG icons**: 매 small size 매 shimmer 방지.
|
||||
|
||||
## 🔗 지식 연결 (Graph)
|
||||
- **Related Topics:** Type Alias (타입 별칭), [[Readonly 유틸리티 타입|Readonly]], Opaque Types (불투명 타입)
|
||||
- **Projects/Contexts:** TypeScript의 불변성(Immutability) 관리, 인터페이스와 타입 별칭 비교(Interface vs Type)
|
||||
- **Contradictions/Notes:** TypeScript의 `readonly`는 컴파일 타임에 불변성을 제공하는 강력한 도구이지만, 에일리어싱을 통해 데이터가 가변 매개변수로 전달될 경우에는 컴파일러가 이를 잡아내지 못하여 데이터가 수정될 수 있다는(얕은 불변성) 근본적인 한계를 지닙니다 [2, 6].
|
||||
## 💻 패턴
|
||||
|
||||
---
|
||||
*Last updated: 2026-04-18*
|
||||
### Canvas 2D antialiasing 활성화
|
||||
```javascript
|
||||
const canvas = document.querySelector('canvas');
|
||||
const ctx = canvas.getContext('2d');
|
||||
|
||||
---
|
||||
// imageSmoothingEnabled: 매 default true
|
||||
ctx.imageSmoothingEnabled = true;
|
||||
ctx.imageSmoothingQuality = 'high'; // 'low' | 'medium' | 'high'
|
||||
|
||||
## 🤖 LLM 활용 힌트 (How to Use This Knowledge)
|
||||
|
||||
**언제 이 지식을 쓰는가:**
|
||||
- *(TODO)*
|
||||
|
||||
**언제 쓰면 안 되는가:**
|
||||
- *(TODO)*
|
||||
|
||||
## 🧪 검증 상태 (Validation)
|
||||
|
||||
- **정보 상태:** needs_review
|
||||
- **출처 신뢰도:** A
|
||||
- **검토 이유:** *(P-Reinforce Phase 1 자동 정규화. 본문 검증 필요.)*
|
||||
|
||||
## 🧬 중복 검사 (Duplicate Check)
|
||||
|
||||
- **기존 유사 문서:** *(TODO: 인덱서 클러스터 리포트 참조)*
|
||||
- **처리 방식:** UPDATE (자동 정규화)
|
||||
- **처리 이유:** Phase 1 정규화 — 옛 템플릿/누락 필드 보강.
|
||||
|
||||
## 🕓 변경 이력 (Changelog)
|
||||
|
||||
| 날짜 | 변경 내용 | 처리 방식 | 신뢰도 |
|
||||
|------|-----------|-----------|--------|
|
||||
| 2026-05-08 | P-Reinforce Phase 1 정규화 (frontmatter + 헤더 표준화) | UPDATE | A |
|
||||
|
||||
## 💻 코드 패턴 (Code Patterns)
|
||||
|
||||
**패턴 1:** *(TODO: 이 프로젝트 컨벤션 반영한 구조 스켈레톤)*
|
||||
|
||||
```text
|
||||
# TODO
|
||||
ctx.drawImage(img, 0, 0, 100, 100);
|
||||
```
|
||||
|
||||
## 🤔 의사결정 기준 (Decision Criteria)
|
||||
### WebGL MSAA (Multi-Sample Anti-Aliasing)
|
||||
```javascript
|
||||
const gl = canvas.getContext('webgl2', {
|
||||
antialias: true, // 매 MSAA 활성화 (browser 가 sample count 결정)
|
||||
});
|
||||
|
||||
**선택 A를 써야 할 때:**
|
||||
- *(TODO)*
|
||||
// 매 explicit sample count (offscreen framebuffer)
|
||||
const fb = gl.createFramebuffer();
|
||||
gl.bindFramebuffer(gl.FRAMEBUFFER, fb);
|
||||
const rb = gl.createRenderbuffer();
|
||||
gl.bindRenderbuffer(gl.RENDERBUFFER, rb);
|
||||
gl.renderbufferStorageMultisample(
|
||||
gl.RENDERBUFFER, 4, gl.RGBA8, width, height
|
||||
);
|
||||
```
|
||||
|
||||
**선택 B를 써야 할 때:**
|
||||
- *(TODO)*
|
||||
### CSS — 매 transform 시 jagged edge 완화
|
||||
```css
|
||||
.rotated {
|
||||
transform: rotate(15deg);
|
||||
/* 매 GPU 가속 + subpixel AA */
|
||||
will-change: transform;
|
||||
backface-visibility: hidden;
|
||||
-webkit-font-smoothing: antialiased;
|
||||
-moz-osx-font-smoothing: grayscale;
|
||||
}
|
||||
|
||||
**기본값:**
|
||||
> *(TODO)*
|
||||
/* 매 image scaling 시 quality */
|
||||
img {
|
||||
image-rendering: auto; /* 매 default — browser AA */
|
||||
/* image-rendering: pixelated; — 매 retro pixel art */
|
||||
/* image-rendering: crisp-edges; — 매 sharp without AA */
|
||||
}
|
||||
```
|
||||
|
||||
## ❌ 안티패턴 (Anti-Patterns)
|
||||
### SVG — 매 sub-pixel rendering
|
||||
```html
|
||||
<!-- 매 매끈한 line: shape-rendering -->
|
||||
<svg viewBox="0 0 100 100">
|
||||
<line
|
||||
x1="10" y1="10" x2="90" y2="50"
|
||||
stroke="black"
|
||||
shape-rendering="geometricPrecision"
|
||||
/>
|
||||
<!-- "geometricPrecision" | "crispEdges" | "auto" -->
|
||||
</svg>
|
||||
```
|
||||
|
||||
- **[안티패턴]:** *(TODO: 무엇을 하면 안 되는가 + 이유 + 대신 무엇을)*
|
||||
### Three.js — 매 FXAA postprocessing
|
||||
```javascript
|
||||
import * as THREE from 'three';
|
||||
import { EffectComposer } from 'three/addons/postprocessing/EffectComposer.js';
|
||||
import { ShaderPass } from 'three/addons/postprocessing/ShaderPass.js';
|
||||
import { FXAAShader } from 'three/addons/shaders/FXAAShader.js';
|
||||
|
||||
const composer = new EffectComposer(renderer);
|
||||
const fxaa = new ShaderPass(FXAAShader);
|
||||
fxaa.material.uniforms.resolution.value.set(
|
||||
1 / window.innerWidth, 1 / window.innerHeight
|
||||
);
|
||||
composer.addPass(fxaa);
|
||||
```
|
||||
|
||||
### Devicepixelratio 보정
|
||||
```javascript
|
||||
function setupHiDPICanvas(canvas) {
|
||||
const dpr = window.devicePixelRatio || 1;
|
||||
const rect = canvas.getBoundingClientRect();
|
||||
|
||||
canvas.width = rect.width * dpr;
|
||||
canvas.height = rect.height * dpr;
|
||||
canvas.style.width = `${rect.width}px`;
|
||||
canvas.style.height = `${rect.height}px`;
|
||||
|
||||
const ctx = canvas.getContext('2d');
|
||||
ctx.scale(dpr, dpr);
|
||||
return ctx;
|
||||
}
|
||||
```
|
||||
|
||||
## 매 결정 기준
|
||||
| 상황 | Approach |
|
||||
|---|---|
|
||||
| 매 SVG icon, vector | shape-rendering="geometricPrecision" |
|
||||
| 매 retina display | devicePixelRatio scaling |
|
||||
| 매 WebGL game | MSAA 4x or FXAA postprocess |
|
||||
| 매 pixel art | image-rendering: pixelated (AA 끄기) |
|
||||
| 매 rotated text | -webkit-font-smoothing: antialiased |
|
||||
|
||||
**기본값**: 매 antialias: true 활성화 + DPR scaling 적용.
|
||||
|
||||
## 🔗 Graph
|
||||
- 부모: [[Computer Graphics]] · [[Signal Processing]]
|
||||
- 변형: [[MSAA]] · [[FXAA]] · [[SMAA]] · [[TAA]]
|
||||
- 응용: [[Canvas Rendering]] · [[WebGL]] · [[SVG]]
|
||||
- Adjacent: [[Nyquist Theorem]] · [[Subpixel Rendering]]
|
||||
|
||||
## 🤖 LLM 활용
|
||||
**언제**: 매 Canvas/WebGL rendering 매 jagged edge 의 완화, retina display 의 sharp output.
|
||||
**언제 X**: 매 pixel art (의도적 jagged), 매 ultra low-end GPU (AA 비용 부담).
|
||||
|
||||
## ❌ 안티패턴
|
||||
- **DPR 무시**: 매 retina 매 blurry — devicePixelRatio scaling 누락.
|
||||
- **AA 항상 max**: 매 mobile GPU 매 fps 저하 — adaptive quality 필요.
|
||||
- **transform 후 sub-pixel position**: 매 0.5px offset 매 blur — translateZ(0) hack.
|
||||
|
||||
## 🧪 검증 / 중복
|
||||
- Verified (MDN Canvas API, WebGL spec, Three.js docs).
|
||||
- 신뢰도 A.
|
||||
|
||||
## 🕓 Changelog
|
||||
| 날짜 | 변경 |
|
||||
|---|---|
|
||||
| 2026-05-08 | Phase 1 |
|
||||
| 2026-05-10 | Manual cleanup — aliasing, AA techniques (MSAA/FXAA), Canvas/WebGL/SVG/CSS 패턴 정리 |
|
||||
|
||||
Reference in New Issue
Block a user