기본 예제
여기에는 Sharp를 빠르게 시작하는 데 도움이 되는 기본 사용 예제가 제공됩니다.
이미지 크기 조정
간단한 크기 조정
javascript
import sharp from 'sharp';
// 지정된 크기로 조정
await sharp('input.jpg')
.resize(300, 200)
.toFile('output.jpg');종횡비 유지
javascript
// 너비만 지정, 높이 자동 계산
await sharp('input.jpg')
.resize(300)
.toFile('output.jpg');
// 높이만 지정, 너비 자동 계산
await sharp('input.jpg')
.resize(null, 200)
.toFile('output.jpg');적합 모드
javascript
// cover: 종횡비 유지, 초과 부분 자르기
await sharp('input.jpg')
.resize(300, 200, { fit: 'cover' })
.toFile('output.jpg');
// contain: 종횡비 유지, 배경 추가
await sharp('input.jpg')
.resize(300, 200, { fit: 'contain', background: { r: 255, g: 255, b: 255 } })
.toFile('output.jpg');형식 변환
JPEG를 PNG로 변환
javascript
await sharp('input.jpg')
.png()
.toFile('output.png');PNG를 JPEG로 변환
javascript
await sharp('input.png')
.jpeg({ quality: 80 })
.toFile('output.jpg');WebP로 변환
javascript
await sharp('input.jpg')
.webp({ quality: 80 })
.toFile('output.webp');AVIF로 변환
javascript
await sharp('input.jpg')
.avif({ quality: 80 })
.toFile('output.avif');이미지 회전
90도 회전
javascript
await sharp('input.jpg')
.rotate(90)
.toFile('output.jpg');자동 회전 (EXIF에 따라)
javascript
await sharp('input.jpg')
.rotate() // 자동 회전
.toFile('output.jpg');이미지 뒤집기
수직 뒤집기
javascript
await sharp('input.jpg')
.flip()
.toFile('output.jpg');수평 뒤집기
javascript
await sharp('input.jpg')
.flop()
.toFile('output.jpg');이미지 자르기
지정된 영역 자르기
javascript
await sharp('input.jpg')
.extract({ left: 100, top: 100, width: 300, height: 200 })
.toFile('output.jpg');자르기 및 크기 조정
javascript
await sharp('input.jpg')
.extract({ left: 100, top: 100, width: 300, height: 200 })
.resize(150, 100)
.toFile('output.jpg');필터 효과
그레이스케일 변환
javascript
await sharp('input.jpg')
.grayscale()
.toFile('output.jpg');블러 효과
javascript
await sharp('input.jpg')
.blur(5)
.toFile('output.jpg');선명화 효과
javascript
await sharp('input.jpg')
.sharpen()
.toFile('output.jpg');색상 반전
javascript
await sharp('input.jpg')
.negate()
.toFile('output.jpg');색상 조정
밝기 조정
javascript
await sharp('input.jpg')
.modulate({ brightness: 1.2 })
.toFile('output.jpg');채도 조정
javascript
await sharp('input.jpg')
.modulate({ saturation: 0.8 })
.toFile('output.jpg');색조 조정
javascript
await sharp('input.jpg')
.modulate({ hue: 180 })
.toFile('output.jpg');투명도 처리
투명도 추가
javascript
await sharp('input.jpg')
.ensureAlpha()
.png()
.toFile('output.png');투명도 제거
javascript
await sharp('input.png')
.flatten({ background: { r: 255, g: 255, b: 255 } })
.jpeg()
.toFile('output.jpg');품질 설정
JPEG 품질
javascript
// 고품질
await sharp('input.png')
.jpeg({ quality: 95 })
.toFile('output.jpg');
// 중간 품질
await sharp('input.png')
.jpeg({ quality: 80 })
.toFile('output.jpg');
// 저품질 (작은 파일)
await sharp('input.png')
.jpeg({ quality: 50 })
.toFile('output.jpg');WebP 품질
javascript
await sharp('input.jpg')
.webp({ quality: 80, lossless: false })
.toFile('output.webp');체인 작업
여러 작업 조합
javascript
await sharp('input.jpg')
.resize(800, 600)
.rotate(90)
.blur(2)
.sharpen()
.jpeg({ quality: 80 })
.toFile('output.jpg');조건부 처리
javascript
const image = sharp('input.jpg').resize(300, 200);
if (needsBlur) {
image.blur(3);
}
if (needsSharpen) {
image.sharpen();
}
await image.jpeg({ quality: 80 }).toFile('output.jpg');오류 처리
기본 오류 처리
javascript
try {
await sharp('input.jpg')
.resize(300, 200)
.toFile('output.jpg');
} catch (error) {
console.error('이미지 처리 실패:', error.message);
}파일 존재 확인
javascript
const fs = require('fs');
if (fs.existsSync('input.jpg')) {
await sharp('input.jpg')
.resize(300, 200)
.toFile('output.jpg');
} else {
console.error('입력 파일이 존재하지 않음');
}스트림 처리
스트림에서 읽기
javascript
const fs = require('fs');
fs.createReadStream('input.jpg')
.pipe(sharp().resize(300, 200))
.pipe(fs.createWriteStream('output.jpg'));스트림으로 출력
javascript
const fs = require('fs');
sharp('input.jpg')
.resize(300, 200)
.jpeg({ quality: 80 })
.pipe(fs.createWriteStream('output.jpg'));Buffer 처리
Buffer에서 생성
javascript
const fs = require('fs');
const inputBuffer = fs.readFileSync('input.jpg');
const outputBuffer = await sharp(inputBuffer)
.resize(300, 200)
.jpeg({ quality: 80 })
.toBuffer();
fs.writeFileSync('output.jpg', outputBuffer);Buffer로 출력
javascript
const buffer = await sharp('input.jpg')
.resize(300, 200)
.jpeg({ quality: 80 })
.toBuffer();
// buffer를 직접 사용할 수 있음
console.log('이미지 크기:', buffer.length);일괄 처리
디렉토리의 모든 이미지 처리
javascript
const fs = require('fs').promises;
const path = require('path');
async function processImages(inputDir, outputDir) {
const files = await fs.readdir(inputDir);
for (const file of files) {
if (file.match(/\.(jpg|jpeg|png|webp)$/i)) {
try {
await sharp(path.join(inputDir, file))
.resize(300, 200)
.jpeg({ quality: 80 })
.toFile(path.join(outputDir, file));
console.log(`처리 완료: ${file}`);
} catch (error) {
console.error(`처리 실패 ${file}:`, error.message);
}
}
}
}
processImages('./input', './output');