Przechwytuj zrzuty ekranu z witryny lub konwertuj HTML na obrazy
Twórz idealne zrzuty ekranu ze stron internetowych lub konwertuj HTML bezpośrednio na obrazy, korzystając z następujących funkcji Interfejs API GrabzIt ASP.NET. Jednak zanim zaczniesz, pamiętaj, że po wywołaniu URLToImage, HTMLToImage or FileToImage metody Save or SaveTo należy wykonać metodę, aby wykonać zrzut ekranu.
Podstawowe opcje
Do zrobienia zrzutu ekranu strony internetowej lub wymagany jest tylko jeden parametr przekonwertować HTML into obrazie jak pokazano w poniższym przykładzie.
grabzIt.URLToImage("https://www.tesla.com");
//Then call the Save or SaveTo method
grabzIt.HTMLToImage("<html><body><h1>Hello World!</h1></body></html>");
//Then call the Save or SaveTo method
grabzIt.FileToImage("example.html");
//Then call the Save or SaveTo method
Formaty zrzutów ekranu
Interfejs API GrabzIt ASP.NET może wykonywać zrzuty ekranu w różnych formatach, w tym JPG, PNG, WEBP, BMP (bit 8, bit 16, bit 24 lub bit 32) i TIFF. Domyślnym formatem zrzutów ekranu jest JPG. Jednak jakość obrazu JPG może być niewystarczająca dla niektórych aplikacji. W takich okolicznościach zalecany jest format PNG do zrzutów ekranu obrazów, ponieważ zapewnia dobrą równowagę między jakością a rozmiarem pliku. Poniższy przykład pokazuje zrzut ekranu wykonany w formacie PNG.
GrabzItClient grabzIt = new GrabzItClient("Sign in to view your Application Key", "Sign in to view your Application Secret");
ImageOptions options = new ImageOptions();
options.Format = ImageFormat.png;
grabzIt.URLToImage("https://www.tesla.com", options);
//Then call the Save or SaveTo method
grabzIt.SaveTo("result.png");
GrabzItClient grabzIt = new GrabzItClient("Sign in to view your Application Key", "Sign in to view your Application Secret");
ImageOptions options = new ImageOptions();
options.Format = ImageFormat.png;
grabzIt.HTMLToImage("<html><body><h1>Hello World!</h1></body></html>", options);
//Then call the Save or SaveTo method
grabzIt.SaveTo("result.png");
GrabzItClient grabzIt = new GrabzItClient("Sign in to view your Application Key", "Sign in to view your Application Secret");
ImageOptions options = new ImageOptions();
options.Format = ImageFormat.png;
grabzIt.FileToImage("example.html", options);
//Then call the Save or SaveTo method
grabzIt.SaveTo("result.png");
Rozmiar przeglądarki
Rozmiar przeglądarki odnosi się do rozmiaru okna przeglądarki, które będzie używane podczas przechwytywania zrzutu ekranu, w większości przypadków nie trzeba go ustawiać, ponieważ domyślny rozmiar przeglądarki będzie wystarczający dla wszystkich większości zadań. Aby ustawić rozmiar przeglądarki, po prostu przekaż wartość do BrowserWidth i BrowserHeight właściwości ImageOptions class.
Zmień rozmiar obrazu
Zmiana rozmiaru obrazu jest łatwa, robienie tego bez zniekształcania obrazu jest nieco trudniejsze. Aby uprościć cały proces, zalecamy skorzystanie z tego prosty kalkulator wymiarów obrazu.
Jeśli chcesz zwiększyć szerokość i wysokość obrazu do rozmiaru większego niż szerokość i wysokość przeglądarki, którym domyślnie jest 1366 na piksele 728, szerokość i wysokość przeglądarki również muszą zostać zwiększone, aby pasowały.
Niestandardowy identyfikator
Możesz przekazać niestandardowy identyfikator do obraz metody, jak pokazano poniżej, ta wartość jest następnie zwracana do modułu obsługi GrabzIt ASP.NET. Na przykład ten niestandardowy identyfikator może być identyfikatorem bazy danych, umożliwiając skojarzenie zrzutu ekranu z określonym rekordem bazy danych.
GrabzItClient grabzIt = new GrabzItClient("Sign in to view your Application Key", "Sign in to view your Application Secret");
ImageOptions options = new ImageOptions();
options.CustomId = "123456";
grabzIt.URLToImage("https://www.tesla.com", options);
//Then call the Save method
grabzIt.Save("http://www.example.com/Home/Handler");
GrabzItClient grabzIt = new GrabzItClient("Sign in to view your Application Key", "Sign in to view your Application Secret");
ImageOptions options = new ImageOptions();
options.CustomId = "123456";
grabzIt.HTMLToImage("<html><body><h1>Hello World!</h1></body></html>", options);
//Then call the Save method
grabzIt.Save("http://www.example.com/Home/Handler");
GrabzItClient grabzIt = new GrabzItClient("Sign in to view your Application Key", "Sign in to view your Application Secret");
ImageOptions options = new ImageOptions();
options.CustomId = "123456";
grabzIt.FileToImage("example.html", options);
//Then call the Save method
grabzIt.Save("http://www.example.com/Home/Handler");
Pełny zrzut ekranu
GrabzIt pozwala zrobić pełny zrzut ekranu całej strony internetowej, aby to zrobić, musisz przekazać -1 do BrowserHeight właściwość ImageOptions klasa. Aby upewnić się, że obraz odpowiada rozmiarowi przeglądarki, przekaż -1 do OutputHeight i OutputWidth Właściwości.
GrabzItClient grabzIt = new GrabzItClient("Sign in to view your Application Key", "Sign in to view your Application Secret");
ImageOptions options = new ImageOptions();
options.BrowserHeight = -1;
options.OutputWidth = -1;
options.OutputHeight = -1;
grabzIt.URLToImage("https://www.tesla.com", options);
//Then call the Save or SaveTo method
grabzIt.SaveTo("result.jpg");
GrabzItClient grabzIt = new GrabzItClient("Sign in to view your Application Key", "Sign in to view your Application Secret");
ImageOptions options = new ImageOptions();
options.BrowserHeight = -1;
options.OutputWidth = -1;
options.OutputHeight = -1;
grabzIt.HTMLToImage("<html><body><h1>Hello World!</h1></body></html>", options);
//Then call the Save or SaveTo method
grabzIt.SaveTo("result.jpg");
GrabzItClient grabzIt = new GrabzItClient("Sign in to view your Application Key", "Sign in to view your Application Secret");
ImageOptions options = new ImageOptions();
options.BrowserHeight = -1;
options.OutputWidth = -1;
options.OutputHeight = -1;
grabzIt.FileToImage("example.html", options);
//Then call the Save or SaveTo method
grabzIt.SaveTo("result.jpg");
Możesz także zwracać miniatury, które nie są przycięte, ale uwaga: może to powodować tworzenie dużych obrazów. Aby to zrobić, przekaż -1 do OutputHeight i / lub OutputWidth nieruchomości. Każdy wymiar, który zostanie przekazany -1, nie zostanie przycięty.
GrabzItClient grabzIt = new GrabzItClient("Sign in to view your Application Key", "Sign in to view your Application Secret");
ImageOptions options = new ImageOptions();
options.OutputWidth = -1;
options.OutputHeight = -1;
grabzIt.URLToImage("https://www.tesla.com", options);
//Then call the Save or SaveTo method
grabzIt.SaveTo("result.jpg");
GrabzItClient grabzIt = new GrabzItClient("Sign in to view your Application Key", "Sign in to view your Application Secret");
ImageOptions options = new ImageOptions();
options.OutputWidth = -1;
options.OutputHeight = -1;
grabzIt.HTMLToImage("<html><body><h1>Hello World!</h1></body></html>", options);
//Then call the Save or SaveTo method
grabzIt.SaveTo("result.jpg");
GrabzItClient grabzIt = new GrabzItClient("Sign in to view your Application Key", "Sign in to view your Application Secret");
ImageOptions options = new ImageOptions();
options.OutputWidth = -1;
options.OutputHeight = -1;
grabzIt.FileToImage("example.html", options);
//Then call the Save or SaveTo method
grabzIt.SaveTo("result.jpg");
Użycie tych specjalnych wartości oznacza, że możesz utworzyć zrzut ekranu, który jest pełnowymiarową wersją całej strony, jeśli chcesz!
Zrób zrzut ekranu elementu strony
GrabzIt pozwala wykonać zrzut ekranu elementu HTML, takiego jak div or span i przechwyć całą jego zawartość. Aby to zrobić, element HTML, którego chcesz zrzut ekranu, musi być określony jako Selektor CSS.
... <div id="features"> <img src="http://www.example.com/hot.jpg"/><h3>Heatwave Starting</h3> </div> ...
W poniższym przykładzie wybierzemy div z identyfikatorem „funkcje” i wyprowadzimy go jako obraz JPEG 250 x 250px.
GrabzItClient grabzIt = new GrabzItClient("Sign in to view your Application Key", "Sign in to view your Application Secret");
// The 250 parameters indicates that image should be sized to 250 x 250 px
ImageOptions options = new ImageOptions();
options.OutputWidth = 250;
options.OutputHeight = 250;
options.Format = ImageFormat.jpg;
options.TargetElement = "#features";
grabzIt.URLToImage("http://www.bbc.co.uk/news", options);
//Then call the Save or SaveTo method
grabzIt.SaveTo("result.jpg");
Następny przykład zawiera kolejny zrzut ekranu „div” funkcji, ale tym razem wyświetla obraz JPEG o dokładnej wielkości div.
GrabzItClient grabzIt = new GrabzItClient("Sign in to view your Application Key", "Sign in to view your Application Secret");
// The -1 indicates that image should not be cropped
ImageOptions options = new ImageOptions();
options.OutputWidth = -1;
options.OutputHeight = -1;
options.BrowserHeight = -1;
options.Format = ImageFormat.jpg;
options.TargetElement = "#features";
grabzIt.URLToImage("http://www.bbc.co.uk/news", options);
//Then call the Save or SaveTo method
grabzIt.SaveTo("result.jpg");