MediaSize

MediaSize (매체 크기)

세로 방향의 매체 치수를 나타내는 2차원 크기 인쇄 속성 클래스예요. X 치수는 아래쪽 가장자리를 따라, Y 치수는 왼쪽 가장자리를 따라 달려요. 따라서 Y 치수는 X 치수보다 크거나 같아야 해요.

출처: Java API Reference

본문

MediaSize 클래스는 많은 표준 매체 크기 값을 선언하며, 이를 ISO, JIS, 북미, 엔지니어링, 기타 매체용 중첩 클래스로 정리해요.

MediaSize는 아직 매체를 지정하는 데 사용되지 않아요. 현재 역할은 이름 붙은 매체의 매핑이에요(MediaSizeName 참고). 클라이언트는 매핑 메서드 MediaSize.getMediaSizeForName(MediaSizeName)을 사용해 이 API에 열거된 MediaSizeName 인스턴스의 물리적 치수를 찾을 수 있어요. 이는 인쇄를 형식화·페이지 나누기 할 때 그 정보가 필요한 클라이언트에게 유용해요.

중첩 클래스 요약

  • MediaSize.Engineering — 엔지니어링 매체용 MediaSize 값을 포함해요.
  • MediaSize.ISO — ISO 매체용 MediaSize 값을 포함해요.
  • MediaSize.JIS — JIS(일본) 매체용 MediaSize 값을 포함해요.
  • MediaSize.NA — 북미 매체용 MediaSize 값을 포함해요.
  • MediaSize.Other — 기타 매체용 MediaSize 값을 포함해요.

생성자 요약

  • MediaSize(float x, float y, int units) — 주어진 부동소수점 값으로 새 매체 크기 속성을 생성해요. x < 0이거나 y < 0, units < 1, x > y이면 IllegalArgumentException을 던져요.
  • MediaSize(int x, int y, int units) — 주어진 정수 값으로 새 매체 크기 속성을 생성해요. x < 0이거나 y < 0, units < 1, x > y이면 IllegalArgumentException을 던져요.
  • MediaSize(float x, float y, int units, MediaSizeName media) — 주어진 부동소수점 값으로 새 매체 크기 속성을 생성해요. 이 MediaSize와 연관할 매체 이름 media를 받아요. x < 0이거나 y < 0, units < 1, x > y이면 IllegalArgumentException을 던져요.
  • MediaSize(int x, int y, int units, MediaSizeName media) — 주어진 정수 값으로 새 매체 크기 속성을 생성해요. x < 0이거나 y < 0, units < 1, x > y이면 IllegalArgumentException을 던져요.

메서드 요약

  • MediaSizeName getMediaSizeName() — 이 크기의 매체 이름(있는 경우)을 가져와요. 이 크기와 연관된 이름이 없으면(익명 크기), null을 반환해요.
  • static MediaSize getMediaSizeForName(MediaSizeName media) — 지정된 이름 붙은 매체에 대한 MediaSize를 가져와요. 이 매체가 어떤 크기와도 연관되지 않았으면 null을 반환해요.
  • static MediaSizeName findMedia(float x, float y, int units) — 지정된 치수를 사용해 모든 표준 MediaSize 인스턴스 중에서 일치하는 MediaSize 인스턴스를 찾아요. 정확히 일치하는 게 없으면 가장 가까운 일치를 사용해요. 해당 MediaSize를 다시 사용해 MediaSizeName 객체를 찾아요. 가장 가까운 일치 MediaSize에 대응하는 Media 인스턴스가 없으면 null을 반환할 수 있어요. 이 메서드는 치수만 있고 그 치수에 대응하는 Media를 찾기 원하는 클라이언트에게 유용해요. x <= 0이거나 y <= 0, units < 1이면 IllegalArgumentException을 던져요.
  • boolean equals(Object object) — 이 매체 크기 속성이 전달받은 객체와 동등한지 여부를 반환해요. 동등하려면 object가 null이 아니고, MediaSize 클래스의 인스턴스이며, X·Y 치수가 모두 같아야 해요.
  • final Class<? extends Attribute> getCategory() — 이 인쇄 속성 값의 "카테고리"로 사용할 인쇄 속성 클래스를 가져와요. MediaSize 클래스와 벤더 정의 하위 클래스의 카테고리는 MediaSize 클래스 자체예요.
  • final String getName() — 이 속성 값이 인스턴스인 카테고리의 이름을 가져와요. MediaSize 클래스와 벤더 정의 하위 클래스의 카테고리 이름은 "media-size"예요.

더 알아보기 (Learn more)