Contrast プロパティ(ActiveX)

イメージまたはアンダーレイの現在のコントラスト値を指定します。

サポートされているプラットフォーム: Windows のみ

構文と要素

VBA:

object.Contrast

object

タイプ: DgnUnderlay、DwfUnderlay、GeomapImage、PdfUnderlay、RasterImage、Wipeout

このプロパティが適用されるオブジェクト。

プロパティの値

読み込み専用: いいえ

タイプ: 整数型

有効範囲は 0 以上 100 以下です。初期値は 50 です。

注意

元のラスター イメージ ファイルまたはアンダーレイ ファイルに影響を与えることなく、画面上のイメージや印刷イメージの明るさ、コントラスト、フェードを調整することができます。イメージを暗くしたり明るくするには、明るさを調整します。コントラストを調整すると、低品質のイメージも読みやすくなります。フェードを調整すると、イメージ上のベクトルが見やすくなり、印刷結果にすかしを入れることができます。

注: モノクロ イメージの場合、明るさ、コントラスト、フェードの調整はできません。

例

VBA:

Sub Example_Contrast()
    ' This example inserts a raster image and finds the current
    ' Contrast of the image. It then changes the Contrast
    ' of the image.
    
    ' This example uses the "2d Projected Polylines.jpg" found in the Sample
    ' directory. If you do not have the image, or if it is located
    ' in a different directory, insert a valid path and name for the
    ' imageName variable below.
    Dim insertionPoint(0 To 2) As Double
    Dim scalefactor As Double
    Dim rotAngleInDegree As Double
    Dim rotAngle As Double
    Dim imageName As String
    Dim raster As AcadRasterImage
    imageName = "C:\AutoCAD\sample\2d Projected Polylines.jpg"
    insertionPoint(0) = 2#: insertionPoint(1) = 2#: insertionPoint(2) = 0#
    scalefactor = 1#
    rotAngleInDegree = 0#
    rotAngle = rotAngleInDegree * 3.141592 / 180#
    
    On Error Resume Next
    
    ' Creates a raster image in model space
    Set raster = ThisDrawing.modelSpace.AddRaster(imageName, insertionPoint, scalefactor, rotAngle)
    If Err.Description = "File error" Then
        MsgBox imageName & " could not be found."
        Exit Sub
    End If

    ' Find the current Contrast
    ThisDrawing.Regen True
    MsgBox "The Contrast is currently set to: " & raster.Contrast, vbInformation
    
    ' Change the Contrast to 5
    raster.Contrast = 5
    ThisDrawing.Regen True
    MsgBox "The Contrast is now set to: " & raster.Contrast, vbInformation
End Sub

Visual LISP:

(vl-load-com)
(defun c:Example_Contrast()
    ;; This example inserts a raster image and finds the current
    ;; Contrast of the image. It then changes the Contrast
    ;; of the image.
    (setq acadObj (vlax-get-acad-object))
    (setq doc (vla-get-ActiveDocument acadObj))

    ;; This example uses the "2d Projected Polylines.jpg" found in the Sample
    ;; directory. If you do not have the image, or if it is located
    ;; in a different directory, insert a valid path and name for the
    ;; imageName variable below.
    (setq insertionPoint (vlax-3d-point 2 2 0)
          imageName ".\\Sample\\VBA\\2d Projected Polylines.jpg"
          scalefactor 1
          rotAngleInDegree 0
          rotAngle (/ (* rotAngleInDegree 3.141592) 180))

    (if (/= (findfile ".\\Sample\\VBA\\2d Projected Polylines.jpg") nil)
        (progn
            ;; Creates a raster image in model space
            (setq modelSpace (vla-get-ModelSpace doc))
            (setq raster (vla-AddRaster modelSpace (findfile ".\\Sample\\VBA\\2d Projected Polylines.jpg") insertionPoint scalefactor rotAngle))
            (vla-ZoomExtents acadObj)

            ;; Find the current contrast
            (vla-Regen doc :vlax-true)
            (alert (strcat "The Contrast is currently set to: " (rtos (vla-get-Contrast raster) 2)))
    
            ;; Change the contrast to 5
            (vla-put-Contrast raster 5)
            (vla-Regen doc :vlax-true)
            (alert (strcat "The Contrast is now set to: " (rtos (vla-get-Contrast raster) 2)))	  
	)
        (alert (strcat imageName " could not be found."))
    )
)